1
0
mirror of https://github.com/Kitware/CMake.git synced 2025-10-22 16:07:49 +08:00

Help: Improve cross-referencing of test LABELS and related features

This commit is contained in:
Craig Scott
2021-11-13 20:45:05 +11:00
parent a77bdefa3e
commit 250acbb099
3 changed files with 12 additions and 2 deletions

View File

@@ -286,6 +286,8 @@ The following example demonstrates how to specify a custom value for the
std::cout << std::cout <<
"<CTestDetails>My Custom Details Value</CTestDetails>" << std::endl; "<CTestDetails>My Custom Details Value</CTestDetails>" << std::endl;
.. _`Additional Labels`:
Additional Labels Additional Labels
""""""""""""""""" """""""""""""""""

View File

@@ -464,6 +464,10 @@ CTest prints timing summary information for each ``LABEL`` and subproject
associated with the tests run. The label time summary will not include labels associated with the tests run. The label time summary will not include labels
that are mapped to subprojects. that are mapped to subprojects.
.. versionadded:: 3.22
Labels added dynamically during test execution are also reported in the
timing summary. See :ref:`Additional Labels`.
When the :prop_test:`PROCESSORS` test property is set, CTest will display a When the :prop_test:`PROCESSORS` test property is set, CTest will display a
weighted test timing result in label and subproject summaries. The time is weighted test timing result in label and subproject summaries. The time is
reported with `sec*proc` instead of just `sec`. reported with `sec*proc` instead of just `sec`.

View File

@@ -1,6 +1,10 @@
LABELS LABELS
------ ------
Specify a list of text labels associated with a test. Specify a list of text labels associated with a test. The labels are
reported in both the ``ctest`` output summary and in dashboard submissions.
They can also be used to filter the set of tests to be executed (see the
``ctest -L`` and ``ctest -LE`` :ref:`CTest Options`).
The list is reported in dashboard submissions. See :ref:`Additional Labels` for adding labels to a test dynamically during
test execution.