diff options
| author | Brad King <brad.king@kitware.com> | 2019-11-15 14:28:37 (GMT) |
|---|---|---|
| committer | Brad King <brad.king@kitware.com> | 2019-11-15 15:08:33 (GMT) |
| commit | 32c165d2636a65362265d20a16e1f914a53882dd (patch) | |
| tree | d7db33083d84370fffc281deda848786fd2b2952 /Help/manual | |
| parent | c1ae0532f3a1d6d2c7b6e8f370be2a6dca89bf93 (diff) | |
| download | CMake-32c165d2636a65362265d20a16e1f914a53882dd.zip CMake-32c165d2636a65362265d20a16e1f914a53882dd.tar.gz CMake-32c165d2636a65362265d20a16e1f914a53882dd.tar.bz2 | |
CTest: Consolidate '--repeat-* n' options as `--repeat *:n`
Combine `--repeat-until-fail`, `--repeat-until-pass`, and
`--repeat-after-timeout` to create a single `--repeat <mode>:<n>`
option. Retain `--repeat-until-fail` too because that has been
available in previous releases.
Diffstat (limited to 'Help/manual')
| -rw-r--r-- | Help/manual/ctest.1.rst | 30 |
1 files changed, 17 insertions, 13 deletions
diff --git a/Help/manual/ctest.1.rst b/Help/manual/ctest.1.rst index 328f579..2a6cb48 100644 --- a/Help/manual/ctest.1.rst +++ b/Help/manual/ctest.1.rst @@ -261,23 +261,27 @@ Options fail, subsequent calls to CTest with the ``--rerun-failed`` option will run the set of tests that most recently failed (if any). -``--repeat-until-fail <n>`` - Require each test to run ``<n>`` times without failing in order to pass. - - This is useful in finding sporadic failures in test cases. +``--repeat <mode>:<n>`` + Run tests repeatedly based on the given ``<mode>`` up to ``<n>`` times. + The modes are: -``--repeat-until-pass <n>`` - Allow each test to run up to ``<n>`` times in order to pass. - Repeats tests if they fail for any reason. + ``until-fail`` + Require each test to run ``<n>`` times without failing in order to pass. + This is useful in finding sporadic failures in test cases. - This is useful in tolerating sporadic failures in test cases. + ``until-pass`` + Allow each test to run up to ``<n>`` times in order to pass. + Repeats tests if they fail for any reason. + This is useful in tolerating sporadic failures in test cases. -``--repeat-after-timeout <n>`` - Allow each test to run up to ``<n>`` times in order to pass. - Repeats tests only if they timeout. + ``after-timeout`` + Allow each test to run up to ``<n>`` times in order to pass. + Repeats tests only if they timeout. + This is useful in tolerating sporadic timeouts in test cases + on busy machines. - This is useful in tolerating sporadic timeouts in test cases - on busy machines. +``--repeat-until-fail <n>`` + Equivalent to ``--repeat until-fail:<n>``. ``--max-width <width>`` Set the max width for a test name to output. |