summaryrefslogtreecommitdiffstats
path: root/Help
diff options
context:
space:
mode:
authorBrad King <brad.king@kitware.com>2015-10-19 17:05:21 (GMT)
committerCMake Topic Stage <kwrobot@kitware.com>2015-10-19 17:05:21 (GMT)
commit919f26ffba4e5b8e1c206182d906081da8c701e9 (patch)
tree684cd7d317661fe20a0a5f86cc9fff40ba7eb37a /Help
parentbf7d21b0cd7bfad2469a4ae337056a754e6b0fe5 (diff)
parentf19d6a2c953aef79a9b807a51c6b7a7379d888cb (diff)
downloadCMake-919f26ffba4e5b8e1c206182d906081da8c701e9.zip
CMake-919f26ffba4e5b8e1c206182d906081da8c701e9.tar.gz
CMake-919f26ffba4e5b8e1c206182d906081da8c701e9.tar.bz2
Merge topic 'doc-add_test-requirements'
f19d6a2c Help: Document add_test expectations of test command (#15798)
Diffstat (limited to 'Help')
-rw-r--r--Help/command/add_test.rst7
1 files changed, 7 insertions, 0 deletions
diff --git a/Help/command/add_test.rst b/Help/command/add_test.rst
index 7e7e6bd..d8a96e9 100644
--- a/Help/command/add_test.rst
+++ b/Help/command/add_test.rst
@@ -28,6 +28,13 @@ quotes, or other characters special in CMake syntax. The options are:
directory set to the build directory corresponding to the
current source directory.
+The given test command is expected to exit with code ``0`` to pass and
+non-zero to fail, or vice-versa if the :prop_test:`WILL_FAIL` test
+property is set. Any output written to stdout or stderr will be
+captured by :manual:`ctest(1)` but does not affect the pass/fail status
+unless the :prop_test:`PASS_REGULAR_EXPRESSION` or
+:prop_test:`FAIL_REGULAR_EXPRESSION` test property is used.
+
The ``COMMAND`` and ``WORKING_DIRECTORY`` options may use "generator
expressions" with the syntax ``$<...>``. See the
:manual:`cmake-generator-expressions(7)` manual for available expressions.