aboutsummaryrefslogtreecommitdiff
path: root/docs/markdown/Unit-tests.md
diff options
context:
space:
mode:
authorJussi Pakkanen <jpakkane@gmail.com>2019-03-03 14:02:16 +0200
committerGitHub <noreply@github.com>2019-03-03 14:02:16 +0200
commit1997ac2478c600336e89b2deb5e75ae02bef0fd3 (patch)
treee13d42ae10a47a0358cfc3765d9717c488872536 /docs/markdown/Unit-tests.md
parent5a22bb79016c5e7fe386c9cf035c8c3517e883f8 (diff)
parent91f847d308b57adec89245308b60ae063026b456 (diff)
downloadmeson-1997ac2478c600336e89b2deb5e75ae02bef0fd3.zip
meson-1997ac2478c600336e89b2deb5e75ae02bef0fd3.tar.gz
meson-1997ac2478c600336e89b2deb5e75ae02bef0fd3.tar.bz2
Merge pull request #4958 from bonzini/tap
Add initial TAP test support
Diffstat (limited to 'docs/markdown/Unit-tests.md')
-rw-r--r--docs/markdown/Unit-tests.md10
1 files changed, 8 insertions, 2 deletions
diff --git a/docs/markdown/Unit-tests.md b/docs/markdown/Unit-tests.md
index a8e7273..9e61739 100644
--- a/docs/markdown/Unit-tests.md
+++ b/docs/markdown/Unit-tests.md
@@ -51,9 +51,15 @@ By default Meson uses as many concurrent processes as there are cores on the tes
$ MESON_TESTTHREADS=5 ninja test
```
-## Skipped tests
+## Skipped tests and hard errors
-Sometimes a test can only determine at runtime that it can not be run. The GNU standard approach in this case is to exit the program with error code 77. Meson will detect this and report these tests as skipped rather than failed. This behavior was added in version 0.37.0.
+Sometimes a test can only determine at runtime that it can not be run.
+
+For the default `exitcode` testing protocol, the GNU standard approach in this case is to exit the program with error code 77. Meson will detect this and report these tests as skipped rather than failed. This behavior was added in version 0.37.0.
+
+For TAP-based tests, skipped tests should print a single line starting with `1..0 # SKIP`.
+
+In addition, sometimes a test fails set up so that it should fail even if it is marked as an expected failure. The GNU standard approach in this case is to exit the program with error code 99. Again, Meson will detect this and report these tests as `ERROR`, ignoring the setting of `should_fail`. This behavior was added in version 0.50.0.
## Testing tool