1
0
mirror of https://github.com/Kitware/CMake.git synced 2025-10-21 06:10:16 +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 <<
"<CTestDetails>My Custom Details Value</CTestDetails>" << std::endl;
.. _`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
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
weighted test timing result in label and subproject summaries. The time is
reported with `sec*proc` instead of just `sec`.

View File

@@ -1,6 +1,10 @@
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.