aboutsummaryrefslogtreecommitdiff
path: root/tests
diff options
context:
space:
mode:
authorDan Fandrich <dan@coneharvesters.com>2007-03-08 20:00:28 +0000
committerDan Fandrich <dan@coneharvesters.com>2007-03-08 20:00:28 +0000
commit7c144d5a7ec62f9191a3651705f2e8d80c2a7865 (patch)
treefd7f473865b1ccbaf979a68b71e6cb67ae14dc87 /tests
parent0f0540d00b4c634015f4bb894a37d869f04d309f (diff)
Made a few cleanups.
Diffstat (limited to 'tests')
-rw-r--r--tests/FILEFORMAT17
1 files changed, 11 insertions, 6 deletions
diff --git a/tests/FILEFORMAT b/tests/FILEFORMAT
index 22c8f5807..f1c803058 100644
--- a/tests/FILEFORMAT
+++ b/tests/FILEFORMAT
@@ -1,11 +1,12 @@
- The test suite's file format is very simple and extendable, closely
+ The test suite's file format is very simple and extensible, closely
resembling XML. All data for a single test case resides in a single
ASCII file. Labels mark the beginning and the end of all sections, and each
label must be written in its own line. Comments are either XML-style
(enclosed with <!-- and -->) or C-style (beginning with #) and must appear
on their own lines and not alongside actual test data. Most test data files
are syntactically valid XML, although a few files are not (lack of
-support for character entities is the biggest omission).
+support for character entities and the preservation of CR/LF characters at
+the end of lines are the biggest differences).
The file begins with a 'testcase' tag, which encompasses the remainder of
the file.
@@ -146,6 +147,7 @@ restart servers.
A command line that if set gets run by the test script before the test. If an
output is displayed by the command line, the test will be skipped and the
(single-line) output will be displayed as reason for not running the test.
+Variables are substituted as in the <command> section.
</precheck>
<tool>
@@ -162,7 +164,8 @@ variable1=contents1
variable2=contents2
Set the given environment variables to the specified value before the actual
-command is run, they are cleared again after the command has been run.
+command is run. They are cleared again after the command has been run.
+Variables are first substituted as in the <command> section.
</setenv>
<command [option="no-output"]>
@@ -200,8 +203,10 @@ Available substitute variables include:
</command>
<file name="log/filename">
-this creates the named file with this content before the test case is run
+This creates the named file with this content before the test case is run,
which is useful if the test case needs a file to act on.
+Variables are substituted on the contents of the file as in the <command>
+section.
</file>
<stdin>
@@ -233,13 +238,13 @@ actually sent by the client
<stdout [mode="text"]>
This verifies that this data was passed to stdout.
-Use the "mode="text"" attribute if the output is in text mode on platforms that
+Use the mode="text" attribute if the output is in text mode on platforms that
have a text/binary difference.
</stdout>
<file name="log/filename" [mode="text"]>
The file's contents must be identical to this after the test is complete.
-Use the "mode="text" attribute if the output is in text mode on platforms that
+Use the mode="text" attribute if the output is in text mode on platforms that
have a text/binary difference.
</file>
<stripfile>