Help: Normalize capitalization of 'CTest' in ctest(1) manual

This commit is contained in:
Betsy McPhail
2017-10-30 12:46:27 -04:00
committed by Brad King
parent 9d3aa95ca4
commit 002d0a1cf9

View File

@@ -61,15 +61,15 @@ Options
``-F`` ``-F``
Enable failover. Enable failover.
This option allows ctest to resume a test set execution that was This option allows CTest to resume a test set execution that was
previously interrupted. If no interruption occurred, the ``-F`` option previously interrupted. If no interruption occurred, the ``-F`` option
will have no effect. will have no effect.
``-j <jobs>, --parallel <jobs>`` ``-j <jobs>, --parallel <jobs>``
Run the tests in parallel using the given number of jobs. Run the tests in parallel using the given number of jobs.
This option tells ctest to run the tests in parallel using given This option tells CTest to run the tests in parallel using given
number of jobs. This option can also be set by setting the number of jobs. This option can also be set by setting the
environment variable ``CTEST_PARALLEL_LEVEL``. environment variable ``CTEST_PARALLEL_LEVEL``.
``--test-load <level>`` ``--test-load <level>``
@@ -80,7 +80,7 @@ Options
``TestLoad`` option of the `CTest Test Step`_. ``TestLoad`` option of the `CTest Test Step`_.
``-Q,--quiet`` ``-Q,--quiet``
Make ctest quiet. Make CTest quiet.
This option will suppress all the output. The output log file will This option will suppress all the output. The output log file will
still be generated if the ``--output-log`` is specified. Options such still be generated if the ``--output-log`` is specified. Options such
@@ -90,37 +90,37 @@ Options
``-O <file>, --output-log <file>`` ``-O <file>, --output-log <file>``
Output to log file. Output to log file.
This option tells ctest to write all its output to a log file. This option tells CTest to write all its output to a log file.
``-N,--show-only`` ``-N,--show-only``
Disable actual execution of tests. Disable actual execution of tests.
This option tells ctest to list the tests that would be run but not This option tells CTest to list the tests that would be run but not
actually run them. Useful in conjunction with the ``-R`` and ``-E`` actually run them. Useful in conjunction with the ``-R`` and ``-E``
options. options.
``-L <regex>, --label-regex <regex>`` ``-L <regex>, --label-regex <regex>``
Run tests with labels matching regular expression. Run tests with labels matching regular expression.
This option tells ctest to run only the tests whose labels match the This option tells CTest to run only the tests whose labels match the
given regular expression. given regular expression.
``-R <regex>, --tests-regex <regex>`` ``-R <regex>, --tests-regex <regex>``
Run tests matching regular expression. Run tests matching regular expression.
This option tells ctest to run only the tests whose names match the This option tells CTest to run only the tests whose names match the
given regular expression. given regular expression.
``-E <regex>, --exclude-regex <regex>`` ``-E <regex>, --exclude-regex <regex>``
Exclude tests matching regular expression. Exclude tests matching regular expression.
This option tells ctest to NOT run the tests whose names match the This option tells CTest to NOT run the tests whose names match the
given regular expression. given regular expression.
``-LE <regex>, --label-exclude <regex>`` ``-LE <regex>, --label-exclude <regex>``
Exclude tests with labels matching regular expression. Exclude tests with labels matching regular expression.
This option tells ctest to NOT run the tests whose labels match the This option tells CTest to NOT run the tests whose labels match the
given regular expression. given regular expression.
``-FA <regex>, --fixture-exclude-any <regex>`` ``-FA <regex>, --fixture-exclude-any <regex>``
@@ -143,7 +143,7 @@ Options
``-D <dashboard>, --dashboard <dashboard>`` ``-D <dashboard>, --dashboard <dashboard>``
Execute dashboard test. Execute dashboard test.
This option tells ctest to act as a CDash client and perform a This option tells CTest to act as a CDash client and perform a
dashboard test. All tests are <Mode><Test>, where Mode can be dashboard test. All tests are <Mode><Test>, where Mode can be
Experimental, Nightly, and Continuous, and Test can be Start, Experimental, Nightly, and Continuous, and Test can be Start,
Update, Configure, Build, Test, Coverage, and Submit. Update, Configure, Build, Test, Coverage, and Submit.
@@ -161,7 +161,7 @@ Options
``-M <model>, --test-model <model>`` ``-M <model>, --test-model <model>``
Sets the model for a dashboard. Sets the model for a dashboard.
This option tells ctest to act as a CDash client where the ``<model>`` This option tells CTest to act as a CDash client where the ``<model>``
can be ``Experimental``, ``Nightly``, and ``Continuous``. can be ``Experimental``, ``Nightly``, and ``Continuous``.
Combining ``-M`` and ``-T`` is similar to ``-D``. Combining ``-M`` and ``-T`` is similar to ``-D``.
@@ -170,7 +170,7 @@ Options
``-T <action>, --test-action <action>`` ``-T <action>, --test-action <action>``
Sets the dashboard action to perform. Sets the dashboard action to perform.
This option tells ctest to act as a CDash client and perform some This option tells CTest to act as a CDash client and perform some
action such as ``start``, ``build``, ``test`` etc. See action such as ``start``, ``build``, ``test`` etc. See
`Dashboard Client Steps`_ for the full list of actions. `Dashboard Client Steps`_ for the full list of actions.
Combining ``-M`` and ``-T`` is similar to ``-D``. Combining ``-M`` and ``-T`` is similar to ``-D``.
@@ -180,9 +180,9 @@ Options
``-S <script>, --script <script>`` ``-S <script>, --script <script>``
Execute a dashboard for a configuration. Execute a dashboard for a configuration.
This option tells ctest to load in a configuration script which sets This option tells CTest to load in a configuration script which sets
a number of parameters such as the binary and source directories. a number of parameters such as the binary and source directories.
Then ctest will do what is required to create and run a dashboard. Then CTest will do what is required to create and run a dashboard.
This option basically sets up a dashboard and then runs ``ctest -D`` This option basically sets up a dashboard and then runs ``ctest -D``
with the appropriate options. with the appropriate options.
@@ -201,7 +201,7 @@ Options
``-I [Start,End,Stride,test#,test#|Test file], --tests-information`` ``-I [Start,End,Stride,test#,test#|Test file], --tests-information``
Run a specific number of tests by number. Run a specific number of tests by number.
This option causes ctest to run tests starting at number Start, This option causes CTest to run tests starting at number Start,
ending at number End, and incrementing by Stride. Any additional ending at number End, and incrementing by Stride. Any additional
numbers after Stride are considered individual test numbers. Start, numbers after Stride are considered individual test numbers. Start,
End,or stride can be empty. Optionally a file can be given that End,or stride can be empty. Optionally a file can be given that
@@ -216,11 +216,11 @@ Options
``--rerun-failed`` ``--rerun-failed``
Run only the tests that failed previously. Run only the tests that failed previously.
This option tells ctest to perform only the tests that failed during This option tells CTest to perform only the tests that failed during
its previous run. When this option is specified, ctest ignores all its previous run. When this option is specified, CTest ignores all
other options intended to modify the list of tests to run (``-L``, ``-R``, other options intended to modify the list of tests to run (``-L``, ``-R``,
``-E``, ``-LE``, ``-I``, etc). In the event that CTest runs and no tests ``-E``, ``-LE``, ``-I``, etc). In the event that CTest runs and no tests
fail, subsequent calls to ctest with the ``--rerun-failed`` option will run fail, subsequent calls to CTest with the ``--rerun-failed`` option will run
the set of tests that most recently failed (if any). the set of tests that most recently failed (if any).
``--repeat-until-fail <n>`` ``--repeat-until-fail <n>``
@@ -238,7 +238,7 @@ Options
``--interactive-debug-mode [0|1]`` ``--interactive-debug-mode [0|1]``
Set the interactive mode to 0 or 1. Set the interactive mode to 0 or 1.
This option causes ctest to run tests in either an interactive mode This option causes CTest to run tests in either an interactive mode
or a non-interactive mode. On Windows this means that in or a non-interactive mode. On Windows this means that in
non-interactive mode, all system debug pop up windows are blocked. non-interactive mode, all system debug pop up windows are blocked.
In dashboard mode (Experimental, Nightly, Continuous), the default In dashboard mode (Experimental, Nightly, Continuous), the default
@@ -248,14 +248,14 @@ Options
``--no-label-summary`` ``--no-label-summary``
Disable timing summary information for labels. Disable timing summary information for labels.
This option tells ctest not to print summary information for each This option tells CTest not to print summary information for each
label associated with the tests run. If there are no labels on the label associated with the tests run. If there are no labels on the
tests, nothing extra is printed. tests, nothing extra is printed.
``--no-subproject-summary`` ``--no-subproject-summary``
Disable timing summary information for subprojects. Disable timing summary information for subprojects.
This option tells ctest not to print summary information for each This option tells CTest not to print summary information for each
subproject associated with the tests run. If there are no subprojects on the subproject associated with the tests run. If there are no subprojects on the
tests, nothing extra is printed. tests, nothing extra is printed.
@@ -271,7 +271,7 @@ See `Build and Test Mode`_.
``--overwrite`` ``--overwrite``
Overwrite CTest configuration option. Overwrite CTest configuration option.
By default ctest uses configuration options from configuration file. By default CTest uses configuration options from configuration file.
This option will overwrite the configuration option. This option will overwrite the configuration option.
``--force-new-ctest-process`` ``--force-new-ctest-process``
@@ -411,7 +411,7 @@ Options for Dashboard Client include:
``-A <file>, --add-notes <file>`` ``-A <file>, --add-notes <file>``
Add a notes file with submission. Add a notes file with submission.
This option tells ctest to include a notes file when submitting This option tells CTest to include a notes file when submitting
dashboard. dashboard.
``--tomorrow-tag`` ``--tomorrow-tag``