From 0e4e830c799c6df7aa5cf67daaa34a963c638dae Mon Sep 17 00:00:00 2001 From: Axel Kohlmeyer Date: Thu, 9 Dec 2021 17:02:20 -0500 Subject: [PATCH] document "slow" and "unstable" labels for unit tests --- doc/src/Build_development.rst | 10 ++++++++++ 1 file changed, 10 insertions(+) diff --git a/doc/src/Build_development.rst b/doc/src/Build_development.rst index 3c2acbaa7e..5492a1e536 100644 --- a/doc/src/Build_development.rst +++ b/doc/src/Build_development.rst @@ -185,6 +185,10 @@ The ``ctest`` command has many options, the most important ones are: - run subset of tests matching the regular expression * - -E - exclude subset of tests matching the regular expression + * - -L + - run subset of tests with a label matching the regular expression + * - -LE + - exclude subset of tests with a label matching the regular expression * - -N - dry-run: display list of tests without running them * - -T memcheck @@ -299,6 +303,12 @@ will destroy the original file, if the generation run does not complete, so using *-g* is recommended unless the YAML file is fully tested and working. +Some of the force style tests are rather slow to run and some are very +sensitive to small differences like CPU architecture, compiler +toolchain, compiler optimization. Those tests are flagged with a "slow" +and/or "unstable" label, and thus those tests can be selectively +excluded with the ``-LE`` flag or selected with the ``-L`` flag. + .. admonition:: Recommendations and notes for YAML files :class: note