summaryrefslogtreecommitdiff
path: root/selftest/README
diff options
context:
space:
mode:
Diffstat (limited to 'selftest/README')
-rw-r--r--selftest/README18
1 files changed, 13 insertions, 5 deletions
diff --git a/selftest/README b/selftest/README
index f8be20a569..3fe6af5362 100644
--- a/selftest/README
+++ b/selftest/README
@@ -11,7 +11,7 @@ the name of the test, the command to run and the environment that should be
provided. Use the included "plantest" function to generate the required output.
Testsuite behaviour
-================================
+===================
Exit code
------------
@@ -31,27 +31,35 @@ for the last announced test.
Accepted commands are:
test
-~~~~~~~~~~~~
+~~~~
test: <NAME>
Announce that a new test with the specified name is starting
success
-~~~~~~~~~~~~~~~
+~~~~~~~
success: <NAME>
Announce that the test with the specified name is done and ran successfully.
failure
-~~~~~~~~~~~~~~~
+~~~~~~~
failure: <NAME>
failure: <NAME> [ REASON ]
Announce that the test with the specified name failed. Optionally, it is
possible to specify a reason it failed.
+xfail
+~~~~~
+xfail: <NAME>
+xfail: <NAME> [ REASON ]
+
+Announce that the test with the specified name failed but that the failure
+was expected, e.g. it's a test for a known bug that hasn't been fixed yet.
+
skip
-~~~~~~~~~~~~
+~~~~
skip: <NAME>
skip: <NAME> [ REASON ]