diff options
| author | Craig Scott <craig.scott@crascit.com> | 2017-08-08 12:02:07 (GMT) |
|---|---|---|
| committer | Craig Scott <craig.scott@crascit.com> | 2017-08-08 12:02:07 (GMT) |
| commit | 2e3d89a70b50b40bb2c762a094eaeec23ff0f114 (patch) | |
| tree | 2920d5f7b0f00d8ccaf18a9cc4bb132d94908ee6 /Help/prop_test/FIXTURES_SETUP.rst | |
| parent | b17b6dbb8e57f159274deec9e458ab421bee09ff (diff) | |
| download | CMake-2e3d89a70b50b40bb2c762a094eaeec23ff0f114.zip CMake-2e3d89a70b50b40bb2c762a094eaeec23ff0f114.tar.gz CMake-2e3d89a70b50b40bb2c762a094eaeec23ff0f114.tar.bz2 | |
Help: Clarify test fixture naming and use
* Make it clearer that fixture names are distinct from test case names.
* Mention -FS, -FC and -FA ctest command line options for overriding
fixture behavior.
Fixes: #17141
Diffstat (limited to 'Help/prop_test/FIXTURES_SETUP.rst')
| -rw-r--r-- | Help/prop_test/FIXTURES_SETUP.rst | 5 |
1 files changed, 3 insertions, 2 deletions
diff --git a/Help/prop_test/FIXTURES_SETUP.rst b/Help/prop_test/FIXTURES_SETUP.rst index a220215..fdb21cc 100644 --- a/Help/prop_test/FIXTURES_SETUP.rst +++ b/Help/prop_test/FIXTURES_SETUP.rst @@ -2,14 +2,15 @@ FIXTURES_SETUP -------------- Specifies a list of fixtures for which the test is to be treated as a setup -test. +test. These fixture names are distinct from test case names and are not +required to have any similarity to the names of tests associated with them. Fixture setup tests are ordinary tests with all of the usual test functionality. Setting the ``FIXTURES_SETUP`` property for a test has two primary effects: - CTest will ensure the test executes before any other test which lists the - fixture(s) in its :prop_test:`FIXTURES_REQUIRED` property. + fixture name(s) in its :prop_test:`FIXTURES_REQUIRED` property. - If CTest is asked to run only a subset of tests (e.g. using regular expressions or the ``--rerun-failed`` option) and the setup test is not in |