summaryrefslogtreecommitdiff
path: root/share/cmake-3.18/Help/prop_test/DISABLED.rst
blob: 1d469e80b317963c67dadedcfc8e308684e039b2 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
DISABLED
--------

If set to ``True``, the test will be skipped and its status will be 'Not Run'. A
``DISABLED`` test will not be counted in the total number of tests and its
completion status will be reported to CDash as ``Disabled``.

A ``DISABLED`` test does not participate in test fixture dependency resolution.
If a ``DISABLED`` test has fixture requirements defined in its
:prop_test:`FIXTURES_REQUIRED` property, it will not cause setup or cleanup
tests for those fixtures to be added to the test set.

If a test with the :prop_test:`FIXTURES_SETUP` property set is ``DISABLED``,
the fixture behavior will be as though that setup test was passing and any test
case requiring that fixture will still run.