summaryrefslogtreecommitdiffstats
path: root/Help/command/ctest_test.rst
diff options
context:
space:
mode:
authorZack Galbreath <zack.galbreath@kitware.com>2021-06-16 15:38:45 (GMT)
committerZack Galbreath <zack.galbreath@kitware.com>2021-06-17 18:09:01 (GMT)
commitbd38749fd43c1d550f7c45e96a97cddb90c29437 (patch)
tree77a9c8b562643f5d7d49e6bb1d468fde51249aab /Help/command/ctest_test.rst
parent11695f5985e9cbd7a5206908fe6d2ea7e77865e9 (diff)
downloadCMake-bd38749fd43c1d550f7c45e96a97cddb90c29437.zip
CMake-bd38749fd43c1d550f7c45e96a97cddb90c29437.tar.gz
CMake-bd38749fd43c1d550f7c45e96a97cddb90c29437.tar.bz2
ctest: allow test output to add labels
Parse test output for <CTestLabel>...</CTestLabel>. If found, add this value to the list of labels associated with this test.
Diffstat (limited to 'Help/command/ctest_test.rst')
-rw-r--r--Help/command/ctest_test.rst15
1 files changed, 15 insertions, 0 deletions
diff --git a/Help/command/ctest_test.rst b/Help/command/ctest_test.rst
index 2153c90..03ec1a4 100644
--- a/Help/command/ctest_test.rst
+++ b/Help/command/ctest_test.rst
@@ -270,3 +270,18 @@ The following example demonstrates how to specify a custom value for the
std::cout <<
"<CTestDetails>My Custom Details Value</CTestDetails>" << std::endl;
+
+Additional Labels
+"""""""""""""""""
+
+The following example demonstrates how to add additional labels to a test
+at runtime.
+
+.. code-block:: c++
+
+ std::cout <<
+ "<CTestLabel>Custom Label 1</CTestLabel>\n" <<
+ "<CTestLabel>Custom Label 2</CTestLabel>" << std::endl;
+
+Use the :prop_test:`LABELS` test property instead for labels that can be
+determined at configure time.