Help: Format manual/*.1.rst options as definition lists

Convert the command-line option documentation formatting from bullet
lists to definition lists.

Help/manual/LINKS.txt

@@ -1,21 +1,25 @@
 The following resources are available to get help using CMake:
 
-* ``Home Page``: http://www.cmake.org
+Home Page
+ http://www.cmake.org
 
-  The primary starting point for learning about CMake.
+ The primary starting point for learning about CMake.
 
-* ``Frequently Asked Questions``: http://www.cmake.org/Wiki/CMake_FAQ
+Frequently Asked Questions
+ http://www.cmake.org/Wiki/CMake_FAQ
 
-  A Wiki is provided containing answers to frequently asked questions.
+ A Wiki is provided containing answers to frequently asked questions.
 
-* ``Online Documentation``: http://www.cmake.org/HTML/Documentation.html
+Online Documentation
+ http://www.cmake.org/HTML/Documentation.html
 
-  Links to available documentation may be found on this web page.
+ Links to available documentation may be found on this web page.
 
-* ``Mailing List``: http://www.cmake.org/HTML/MailingLists.html
+Mailing List
+ http://www.cmake.org/HTML/MailingLists.html
 
-  For help and discussion about using cmake, a mailing list is
-  provided at [email protected].  The list is member-post-only but one
-  may sign up on the CMake web page.  Please first read the full
-  documentation at http://www.cmake.org before posting questions to
-  the list.
+ For help and discussion about using cmake, a mailing list is
+ provided at [email protected].  The list is member-post-only but one
+ may sign up on the CMake web page.  Please first read the full
+ documentation at http://www.cmake.org before posting questions to
+ the list.

Help/manual/OPTIONS_BUILD.txt

@@ -1,57 +1,64 @@
-* ``-C <initial-cache>``: Pre-load a script to populate the cache.
+``-C <initial-cache>``
+ Pre-load a script to populate the cache.
 
-  When cmake is first run in an empty build tree, it creates a
-  CMakeCache.txt file and populates it with customizable settings for
-  the project.  This option may be used to specify a file from which
-  to load cache entries before the first pass through the project's
-  cmake listfiles.  The loaded entries take priority over the
-  project's default values.  The given file should be a CMake script
-  containing SET commands that use the CACHE option, not a
-  cache-format file.
+ When cmake is first run in an empty build tree, it creates a
+ CMakeCache.txt file and populates it with customizable settings for
+ the project.  This option may be used to specify a file from which
+ to load cache entries before the first pass through the project's
+ cmake listfiles.  The loaded entries take priority over the
+ project's default values.  The given file should be a CMake script
+ containing SET commands that use the CACHE option, not a
+ cache-format file.
 
-* ``-D <var>:<type>=<value>``: Create a cmake cache entry.
+``-D <var>:<type>=<value>``
+ Create a cmake cache entry.
 
-  When cmake is first run in an empty build tree, it creates a
-  CMakeCache.txt file and populates it with customizable settings for
-  the project.  This option may be used to specify a setting that
-  takes priority over the project's default value.  The option may be
-  repeated for as many cache entries as desired.
+ When cmake is first run in an empty build tree, it creates a
+ CMakeCache.txt file and populates it with customizable settings for
+ the project.  This option may be used to specify a setting that
+ takes priority over the project's default value.  The option may be
+ repeated for as many cache entries as desired.
 
-* ``-U <globbing_expr>``: Remove matching entries from CMake cache.
+``-U <globbing_expr>``
+ Remove matching entries from CMake cache.
 
-  This option may be used to remove one or more variables from the
-  CMakeCache.txt file, globbing expressions using * and ? are
-  supported.  The option may be repeated for as many cache entries as
-  desired.
+ This option may be used to remove one or more variables from the
+ CMakeCache.txt file, globbing expressions using * and ? are
+ supported.  The option may be repeated for as many cache entries as
+ desired.
 
-  Use with care, you can make your CMakeCache.txt non-working.
+ Use with care, you can make your CMakeCache.txt non-working.
 
-* ``-G <generator-name>``: Specify a build system generator.
+``-G <generator-name>``
+ Specify a build system generator.
 
-  CMake may support multiple native build systems on certain
-  platforms.  A generator is responsible for generating a particular
-  build system.  Possible generator names are specified in the
-  Generators section.
+ CMake may support multiple native build systems on certain
+ platforms.  A generator is responsible for generating a particular
+ build system.  Possible generator names are specified in the
+ Generators section.
 
-* ``-T <toolset-name>``: Specify toolset name if supported by generator.
+``-T <toolset-name>``
+ Specify toolset name if supported by generator.
 
-  Some CMake generators support a toolset name to be given to the
-  native build system to choose a compiler.  This is supported only on
-  specific generators:
+ Some CMake generators support a toolset name to be given to the
+ native build system to choose a compiler.  This is supported only on
+ specific generators:
 
-  ::
+ ::
 
-    Visual Studio >= 10
-    Xcode >= 3.0
+   Visual Studio >= 10
+   Xcode >= 3.0
 
-  See native build system documentation for allowed toolset names.
+ See native build system documentation for allowed toolset names.
 
-* ``-Wno-dev``: Suppress developer warnings.
+``-Wno-dev``
+ Suppress developer warnings.
 
-  Suppress warnings that are meant for the author of the
-  CMakeLists.txt files.
+ Suppress warnings that are meant for the author of the
+ CMakeLists.txt files.
 
-* ``-Wdev``: Enable developer warnings.
+``-Wdev``
+ Enable developer warnings.
 
-  Enable warnings that are meant for the author of the CMakeLists.txt
-  files.
+ Enable warnings that are meant for the author of the CMakeLists.txt
+ files.

Help/manual/OPTIONS_HELP.txt

@@ -1,111 +1,130 @@
 .. |file| replace:: The help is printed to a named <f>ile if given.
 
-* ``--help,-help,-usage,-h,-H,/?``: Print usage information and exit.
+``--help,-help,-usage,-h,-H,/?``
+ Print usage information and exit.
 
-  Usage describes the basic command line interface and its options.
+ Usage describes the basic command line interface and its options.
 
-* ``--version,-version,/V [<f>]``: Show program name/version banner and exit.
+``--version,-version,/V [<f>]``
+ Show program name/version banner and exit.
 
-  If a file is specified, the version is written into it.
-  |file|
+ If a file is specified, the version is written into it.
+ |file|
 
-* ``--help-manual <man> [<f>]``: Print one help manual and exit.
+``--help-manual <man> [<f>]``
+ Print one help manual and exit.
 
-  The specified manual is printed in a human-readable text format.
-  |file|
+ The specified manual is printed in a human-readable text format.
+ |file|
 
-* ``--help-manual-list [<f>]``: List help manuals available and exit.
+``--help-manual-list [<f>]``
+ List help manuals available and exit.
 
-  The list contains all manuals for which help may be obtained by
-  using the ``--help-manual`` option followed by a manual name.
-  |file|
+ The list contains all manuals for which help may be obtained by
+ using the ``--help-manual`` option followed by a manual name.
+ |file|
 
-* ``--help-command <cmd> [<f>]``: Print help for one command and exit.
+``--help-command <cmd> [<f>]``
+ Print help for one command and exit.
 
-  The :manual:`cmake-commands(7)` manual entry for ``<cmd>`` is
-  printed in a human-readable text format.
-  |file|
+ The :manual:`cmake-commands(7)` manual entry for ``<cmd>`` is
+ printed in a human-readable text format.
+ |file|
 
-* ``--help-command-list [<f>]``: List commands with help available and exit.
+``--help-command-list [<f>]``
+ List commands with help available and exit.
 
-  The list contains all commands for which help may be obtained by
-  using the ``--help-command`` option followed by a command name.
-  |file|
+ The list contains all commands for which help may be obtained by
+ using the ``--help-command`` option followed by a command name.
+ |file|
 
-* ``--help-commands [<f>]``: Print cmake-commands manual and exit.
+``--help-commands [<f>]``
+ Print cmake-commands manual and exit.
 
-  The :manual:`cmake-commands(7)` manual is printed in a
-  human-readable text format.
-  |file|
+ The :manual:`cmake-commands(7)` manual is printed in a
+ human-readable text format.
+ |file|
 
-* ``--help-module <mod> [<f>]``: Print help for one module and exit.
+``--help-module <mod> [<f>]``
+ Print help for one module and exit.
 
-  The :manual:`cmake-modules(7)` manual entry for ``<mod>`` is printed
-  in a human-readable text format.
-  |file|
+ The :manual:`cmake-modules(7)` manual entry for ``<mod>`` is printed
+ in a human-readable text format.
+ |file|
 
-* ``--help-module-list [<f>]``: List modules with help available and exit.
+``--help-module-list [<f>]``
+ List modules with help available and exit.
 
-  The list contains all modules for which help may be obtained by
-  using the ``--help-module`` option followed by a module name.
-  |file|
+ The list contains all modules for which help may be obtained by
+ using the ``--help-module`` option followed by a module name.
+ |file|
 
-* ``--help-modules [<f>]``: Print cmake-modules manual and exit.
+``--help-modules [<f>]``
+ Print cmake-modules manual and exit.
 
-  The :manual:`cmake-modules(7)` manual is printed in a human-readable
-  text format.
-  |file|
+ The :manual:`cmake-modules(7)` manual is printed in a human-readable
+ text format.
+ |file|
 
-* ``--help-policy <cmp> [<f>]``: Print help for one policy and exit.
+``--help-policy <cmp> [<f>]``
+ Print help for one policy and exit.
 
-  The :manual:`cmake-policies(7)` manual entry for ``<cmp>`` is
-  printed in a human-readable text format.
-  |file|
+ The :manual:`cmake-policies(7)` manual entry for ``<cmp>`` is
+ printed in a human-readable text format.
+ |file|
 
-* ``--help-policy-list [<f>]``: List policies with help available and exit.
+``--help-policy-list [<f>]``
+ List policies with help available and exit.
 
-  The list contains all policies for which help may be obtained by
-  using the ``--help-policy`` option followed by a policy name.
-  |file|
+ The list contains all policies for which help may be obtained by
+ using the ``--help-policy`` option followed by a policy name.
+ |file|
 
-* ``--help-policies [<f>]``: Print cmake-policies manual and exit.
+``--help-policies [<f>]``
+ Print cmake-policies manual and exit.
 
-  The :manual:`cmake-policies(7)` manual is printed in a
-  human-readable text format.
-  |file|
+ The :manual:`cmake-policies(7)` manual is printed in a
+ human-readable text format.
+ |file|
 
-* ``--help-property <prop> [<f>]``: Print help for one property and exit.
+``--help-property <prop> [<f>]``
+ Print help for one property and exit.
 
-  The :manual:`cmake-properties(7)` manual entries for ``<prop>`` are
-  printed in a human-readable text format.
-  |file|
+ The :manual:`cmake-properties(7)` manual entries for ``<prop>`` are
+ printed in a human-readable text format.
+ |file|
 
-* ``--help-property-list [<f>]``: List properties with help available and exit.
+``--help-property-list [<f>]``
+ List properties with help available and exit.
 
-  The list contains all properties for which help may be obtained by
-  using the ``--help-property`` option followed by a property name.
-  |file|
+ The list contains all properties for which help may be obtained by
+ using the ``--help-property`` option followed by a property name.
+ |file|
 
-* ``--help-properties [<f>]``: Print cmake-properties manual and exit.
+``--help-properties [<f>]``
+ Print cmake-properties manual and exit.
 
-  The :manual:`cmake-properties(7)` manual is printed in a
-  human-readable text format.
-  |file|
+ The :manual:`cmake-properties(7)` manual is printed in a
+ human-readable text format.
+ |file|
 
-* ``--help-variable <var> [<f>]``: Print help for one variable and exit.
+``--help-variable <var> [<f>]``
+ Print help for one variable and exit.
 
-  The :manual:`cmake-variables(7)` manual entry for ``<var>`` is
-  printed in a human-readable text format.
-  |file|
+ The :manual:`cmake-variables(7)` manual entry for ``<var>`` is
+ printed in a human-readable text format.
+ |file|
 
-* ``--help-variable-list [<f>]``: List variables with help available and exit.
+``--help-variable-list [<f>]``
+ List variables with help available and exit.
 
-  The list contains all variables for which help may be obtained by
-  using the ``--help-variable`` option followed by a variable name.
-  |file|
+ The list contains all variables for which help may be obtained by
+ using the ``--help-variable`` option followed by a variable name.
+ |file|
 
-* ``--help-variables [<f>]``: Print cmake-variables manual and exit.
+``--help-variables [<f>]``
+ Print cmake-variables manual and exit.
 
-  The :manual:`cmake-variables(7)` manual is printed in a
-  human-readable text format.
-  |file|
+ The :manual:`cmake-variables(7)` manual is printed in a
+ human-readable text format.
+ |file|

Help/manual/cmake.1.rst

@@ -32,112 +32,127 @@ Options
 
 .. include:: OPTIONS_BUILD.txt
 
-* ``-E``: CMake command mode.
+``-E``
+ CMake command mode.
 
-  For true platform independence, CMake provides a list of commands
-  that can be used on all systems.  Run with -E help for the usage
-  information.  Commands available are: chdir, compare_files, copy,
-  copy_directory, copy_if_different, echo, echo_append, environment,
-  make_directory, md5sum, remove, remove_directory, rename, tar, time,
-  touch, touch_nocreate.  In addition, some platform specific commands
-  are available.  On Windows: delete_regv, write_regv.  On
-  UNIX: create_symlink.
+ For true platform independence, CMake provides a list of commands
+ that can be used on all systems.  Run with -E help for the usage
+ information.  Commands available are: chdir, compare_files, copy,
+ copy_directory, copy_if_different, echo, echo_append, environment,
+ make_directory, md5sum, remove, remove_directory, rename, tar, time,
+ touch, touch_nocreate.  In addition, some platform specific commands
+ are available.  On Windows: delete_regv, write_regv.  On
+ UNIX: create_symlink.
 
-* ``-L[A][H]``: List non-advanced cached variables.
+``-L[A][H]``
+ List non-advanced cached variables.
 
-  List cache variables will run CMake and list all the variables from
-  the CMake cache that are not marked as INTERNAL or ADVANCED.  This
-  will effectively display current CMake settings, which can then be
-  changed with -D option.  Changing some of the variables may result
-  in more variables being created.  If A is specified, then it will
-  display also advanced variables.  If H is specified, it will also
-  display help for each variable.
+ List cache variables will run CMake and list all the variables from
+ the CMake cache that are not marked as INTERNAL or ADVANCED.  This
+ will effectively display current CMake settings, which can then be
+ changed with -D option.  Changing some of the variables may result
+ in more variables being created.  If A is specified, then it will
+ display also advanced variables.  If H is specified, it will also
+ display help for each variable.
 
-* ``--build <dir>``: Build a CMake-generated project binary tree.
+``--build <dir>``
+ Build a CMake-generated project binary tree.
 
-  This abstracts a native build tool's command-line interface with the
-  following options:
+ This abstracts a native build tool's command-line interface with the
+ following options:
 
-  ::
+ ::
 
-    <dir>          = Project binary directory to be built.
-    --target <tgt> = Build <tgt> instead of default targets.
-    --config <cfg> = For multi-configuration tools, choose <cfg>.
-    --clean-first  = Build target 'clean' first, then build.
-                     (To clean only, use --target 'clean'.)
-    --use-stderr   = Ignored.  Behavior is default in CMake >= 3.0.
-    --             = Pass remaining options to the native tool.
+   <dir>          = Project binary directory to be built.
+   --target <tgt> = Build <tgt> instead of default targets.
+   --config <cfg> = For multi-configuration tools, choose <cfg>.
+   --clean-first  = Build target 'clean' first, then build.
+                    (To clean only, use --target 'clean'.)
+   --use-stderr   = Ignored.  Behavior is default in CMake >= 3.0.
+   --             = Pass remaining options to the native tool.
 
-  Run cmake --build with no options for quick help.
+ Run cmake --build with no options for quick help.
 
-* ``-N``: View mode only.
+``-N``
+ View mode only.
 
-  Only load the cache.  Do not actually run configure and generate
-  steps.
+ Only load the cache.  Do not actually run configure and generate
+ steps.
 
-* ``-P <file>``: Process script mode.
+``-P <file>``
+ Process script mode.
 
-  Process the given cmake file as a script written in the CMake
-  language.  No configure or generate step is performed and the cache
-  is not modified.  If variables are defined using -D, this must be
-  done before the -P argument.
+ Process the given cmake file as a script written in the CMake
+ language.  No configure or generate step is performed and the cache
+ is not modified.  If variables are defined using -D, this must be
+ done before the -P argument.
 
-* ``--find-package``: Run in pkg-config like mode.
+``--find-package``
+ Run in pkg-config like mode.
 
-  Search a package using find_package() and print the resulting flags
-  to stdout.  This can be used to use cmake instead of pkg-config to
-  find installed libraries in plain Makefile-based projects or in
-  autoconf-based projects (via share/aclocal/cmake.m4).
+ Search a package using find_package() and print the resulting flags
+ to stdout.  This can be used to use cmake instead of pkg-config to
+ find installed libraries in plain Makefile-based projects or in
+ autoconf-based projects (via share/aclocal/cmake.m4).
 
-* ``--graphviz=[file]``: Generate graphviz of dependencies, see CMakeGraphVizOptions.cmake for more.
+``--graphviz=[file]``
+ Generate graphviz of dependencies, see CMakeGraphVizOptions.cmake for more.
 
-  Generate a graphviz input file that will contain all the library and
-  executable dependencies in the project.  See the documentation for
-  CMakeGraphVizOptions.cmake for more details.
+ Generate a graphviz input file that will contain all the library and
+ executable dependencies in the project.  See the documentation for
+ CMakeGraphVizOptions.cmake for more details.
 
-* ``--system-information [file]``: Dump information about this system.
+``--system-information [file]``
+ Dump information about this system.
 
-  Dump a wide range of information about the current system.  If run
-  from the top of a binary tree for a CMake project it will dump
-  additional information such as the cache, log files etc.
+ Dump a wide range of information about the current system.  If run
+ from the top of a binary tree for a CMake project it will dump
+ additional information such as the cache, log files etc.
 
-* ``--debug-trycompile``: Do not delete the try_compile build tree. Only useful on one try_compile at a time.
+``--debug-trycompile``
+ Do not delete the try_compile build tree. Only useful on one try_compile at a time.
 
-  Do not delete the files and directories created for try_compile
-  calls.  This is useful in debugging failed try_compiles.  It may
-  however change the results of the try-compiles as old junk from a
-  previous try-compile may cause a different test to either pass or
-  fail incorrectly.  This option is best used for one try-compile at a
-  time, and only when debugging.
+ Do not delete the files and directories created for try_compile
+ calls.  This is useful in debugging failed try_compiles.  It may
+ however change the results of the try-compiles as old junk from a
+ previous try-compile may cause a different test to either pass or
+ fail incorrectly.  This option is best used for one try-compile at a
+ time, and only when debugging.
 
-* ``--debug-output``: Put cmake in a debug mode.
+``--debug-output``
+ Put cmake in a debug mode.
 
-  Print extra stuff during the cmake run like stack traces with
-  message(send_error ) calls.
+ Print extra stuff during the cmake run like stack traces with
+ message(send_error ) calls.
 
-* ``--trace``: Put cmake in trace mode.
+``--trace``
+ Put cmake in trace mode.
 
-  Print a trace of all calls made and from where with
-  message(send_error ) calls.
+ Print a trace of all calls made and from where with
+ message(send_error ) calls.
 
-* ``--warn-uninitialized``: Warn about uninitialized values.
+``--warn-uninitialized``
+ Warn about uninitialized values.
 
-  Print a warning when an uninitialized variable is used.
+ Print a warning when an uninitialized variable is used.
 
-* ``--warn-unused-vars``: Warn about unused variables.
+``--warn-unused-vars``
+ Warn about unused variables.
 
-  Find variables that are declared or set, but not used.
+ Find variables that are declared or set, but not used.
 
-* ``--no-warn-unused-cli``: Don't warn about command line options.
+``--no-warn-unused-cli``
+ Don't warn about command line options.
 
-  Don't find variables that are declared on the command line, but not
-  used.
+ Don't find variables that are declared on the command line, but not
+ used.
 
-* ``--check-system-vars``: Find problems with variable usage in system files.
+``--check-system-vars``
+ Find problems with variable usage in system files.
 
-  Normally, unused and uninitialized variables are searched for only
-  in CMAKE_SOURCE_DIR and CMAKE_BINARY_DIR.  This flag tells CMake to
-  warn about other files as well.
+ Normally, unused and uninitialized variables are searched for only
+ in CMAKE_SOURCE_DIR and CMAKE_BINARY_DIR.  This flag tells CMake to
+ warn about other files as well.
 
 .. include:: OPTIONS_HELP.txt
 

Help/manual/cpack.1.rst

@@ -27,57 +27,67 @@ native tool on their platform.
 Options
 =======
 
-* ``-G <generator>``: Use the specified generator to generate package.
+``-G <generator>``
+ Use the specified generator to generate package.
 
-  CPack may support multiple native packaging systems on certain
-  platforms.  A generator is responsible for generating input files
-  for particular system and invoking that systems.  Possible generator
-  names are specified in the Generators section.
+ CPack may support multiple native packaging systems on certain
+ platforms.  A generator is responsible for generating input files
+ for particular system and invoking that systems.  Possible generator
+ names are specified in the Generators section.
 
-* ``-C <Configuration>``: Specify the project configuration
+``-C <Configuration>``
+ Specify the project configuration
 
-  This option specifies the configuration that the project was build
-  with, for example 'Debug', 'Release'.
+ This option specifies the configuration that the project was build
+ with, for example 'Debug', 'Release'.
 
-* ``-D <var>=<value>``: Set a CPack variable.
+``-D <var>=<value>``
+ Set a CPack variable.
 
-  Set a variable that can be used by the generator.
+ Set a variable that can be used by the generator.
 
-* ``--config <config file>``: Specify the config file.
+``--config <config file>``
+ Specify the config file.
 
-  Specify the config file to use to create the package.  By default
-  CPackConfig.cmake in the current directory will be used.
+ Specify the config file to use to create the package.  By default
+ CPackConfig.cmake in the current directory will be used.
 
-* ``--verbose,-V``: enable verbose output
+``--verbose,-V``
+ enable verbose output
 
-  Run cpack with verbose output.
+ Run cpack with verbose output.
 
-* ``--debug``: enable debug output (for CPack developers)
+``--debug``
+ enable debug output (for CPack developers)
 
-  Run cpack with debug output (for CPack developers).
+ Run cpack with debug output (for CPack developers).
 
-* ``-P <package name>``: override/define CPACK_PACKAGE_NAME
+``-P <package name>``
+ override/define CPACK_PACKAGE_NAME
 
-  If the package name is not specified on cpack commmand line
-  thenCPack.cmake defines it as CMAKE_PROJECT_NAME
+ If the package name is not specified on cpack commmand line
+ thenCPack.cmake defines it as CMAKE_PROJECT_NAME
 
-* ``-R <package version>``: override/define CPACK_PACKAGE_VERSION
+``-R <package version>``
+ override/define CPACK_PACKAGE_VERSION
 
-  If version is not specified on cpack command line thenCPack.cmake
-  defines it from CPACK_PACKAGE_VERSION_[MAJOR|MINOR|PATCH]look into
-  CPack.cmake for detail
+ If version is not specified on cpack command line thenCPack.cmake
+ defines it from CPACK_PACKAGE_VERSION_[MAJOR|MINOR|PATCH]look into
+ CPack.cmake for detail
 
-* ``-B <package directory>``: override/define CPACK_PACKAGE_DIRECTORY
+``-B <package directory>``
+ override/define CPACK_PACKAGE_DIRECTORY
 
-  The directory where CPack will be doing its packaging work.The
-  resulting package will be found there.  Inside this directoryCPack
-  creates '_CPack_Packages' sub-directory which is theCPack temporary
-  directory.
+ The directory where CPack will be doing its packaging work.The
+ resulting package will be found there.  Inside this directoryCPack
+ creates '_CPack_Packages' sub-directory which is theCPack temporary
+ directory.
 
-* ``--vendor <vendor name>``: override/define CPACK_PACKAGE_VENDOR
+``--vendor <vendor name>``
+ override/define CPACK_PACKAGE_VENDOR
 
-  If vendor is not specified on cpack command line (or inside
-  CMakeLists.txt) thenCPack.cmake defines it with a default value
+ If vendor is not specified on cpack command line (or inside
+ CMakeLists.txt) thenCPack.cmake defines it with a default value
 
 .. include:: OPTIONS_HELP.txt
 

Help/manual/ctest.1.rst

@@ -21,292 +21,347 @@ program will run the tests and report results.
 Options
 =======
 
-* ``-C <cfg>, --build-config <cfg>``: Choose configuration to test.
+``-C <cfg>, --build-config <cfg>``
+ Choose configuration to test.
 
-  Some CMake-generated build trees can have multiple build
-  configurations in the same tree.  This option can be used to specify
-  which one should be tested.  Example configurations are "Debug" and
-  "Release".
+ Some CMake-generated build trees can have multiple build
+ configurations in the same tree.  This option can be used to specify
+ which one should be tested.  Example configurations are "Debug" and
+ "Release".
 
-* ``-V,--verbose``: Enable verbose output from tests.
+``-V,--verbose``
+ Enable verbose output from tests.
 
-  Test output is normally suppressed and only summary information is
-  displayed.  This option will show all test output.
+ Test output is normally suppressed and only summary information is
+ displayed.  This option will show all test output.
 
-* ``-VV,--extra-verbose``: Enable more verbose output from tests.
+``-VV,--extra-verbose``
+ Enable more verbose output from tests.
 
-  Test output is normally suppressed and only summary information is
-  displayed.  This option will show even more test output.
+ Test output is normally suppressed and only summary information is
+ displayed.  This option will show even more test output.
 
-* ``--debug``: Displaying more verbose internals of CTest.
+``--debug``
+ Displaying more verbose internals of CTest.
 
-  This feature will result in a large number of output that is mostly
-  useful for debugging dashboard problems.
+ This feature will result in a large number of output that is mostly
+ useful for debugging dashboard problems.
 
-* ``--output-on-failure``: Output anything outputted by the test program if the test should fail.  This option can also be enabled by setting the environment variable CTEST_OUTPUT_ON_FAILURE
+``--output-on-failure``
+ Output anything outputted by the test program if the test should fail.  This option can also be enabled by setting the environment variable CTEST_OUTPUT_ON_FAILURE
 
-* ``-F``: Enable failover.
+``-F``
+ Enable failover.
 
-  This option allows ctest to resume a test set execution that was
-  previously interrupted.  If no interruption occurred, the -F option
-  will have no effect.
+ This option allows ctest to resume a test set execution that was
+ previously interrupted.  If no interruption occurred, the -F option
+ will have no effect.
 
-* ``-j <jobs>, --parallel <jobs>``: Run the tests in parallel using thegiven number of jobs.
+``-j <jobs>, --parallel <jobs>``
+ Run the tests in parallel using thegiven number of jobs.
 
-  This option tells ctest to run the tests in parallel using given
-  number of jobs.  This option can also be set by setting the
-  environment variable CTEST_PARALLEL_LEVEL.
+ This option tells ctest to run the tests in parallel using given
+ number of jobs.  This option can also be set by setting the
+ environment variable CTEST_PARALLEL_LEVEL.
 
-* ``-Q,--quiet``: Make ctest quiet.
+``-Q,--quiet``
+ Make ctest quiet.
 
-  This option will suppress all the output.  The output log file will
-  still be generated if the --output-log is specified.  Options such
-  as --verbose, --extra-verbose, and --debug are ignored if --quiet is
-  specified.
+ This option will suppress all the output.  The output log file will
+ still be generated if the --output-log is specified.  Options such
+ as --verbose, --extra-verbose, and --debug are ignored if --quiet is
+ specified.
 
-* ``-O <file>, --output-log <file>``: Output to log file
+``-O <file>, --output-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``: Disable actual execution of tests.
+``-N,--show-only``
+ Disable actual execution of tests.
 
-  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
-  options.
+ 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
+ options.
 
-* ``-L <regex>, --label-regex <regex>``: Run tests with labels matching regular expression.
+``-L <regex>, --label-regex <regex>``
+ Run tests with labels matching regular expression.
 
-  This option tells ctest to run only the tests whose labels match the
-  given regular expression.
+ This option tells ctest to run only the tests whose labels match the
+ given regular expression.
 
-* ``-R <regex>, --tests-regex <regex>``: Run tests matching regular expression.
+``-R <regex>, --tests-regex <regex>``
+ Run tests matching regular expression.
 
-  This option tells ctest to run only the tests whose names match the
-  given regular expression.
+ This option tells ctest to run only the tests whose names match the
+ given regular expression.
 
-* ``-E <regex>, --exclude-regex <regex>``: Exclude tests matching regular expression.
+``-E <regex>, --exclude-regex <regex>``
+ Exclude tests matching regular expression.
 
-  This option tells ctest to NOT run the tests whose names match the
-  given regular expression.
+ This option tells ctest to NOT run the tests whose names match the
+ given regular expression.
 
-* ``-LE <regex>, --label-exclude <regex>``: Exclude tests with labels matching regular expression.
+``-LE <regex>, --label-exclude <regex>``
+ Exclude tests with labels matching regular expression.
 
-  This option tells ctest to NOT run the tests whose labels match the
-  given regular expression.
+ This option tells ctest to NOT run the tests whose labels match the
+ given regular expression.
 
-* ``-D <dashboard>, --dashboard <dashboard>``: Execute dashboard test
+``-D <dashboard>, --dashboard <dashboard>``
+ Execute dashboard test
 
-  This option tells ctest to act as a Dart client and perform a
-  dashboard test.  All tests are <Mode><Test>, where Mode can be
-  Experimental, Nightly, and Continuous, and Test can be Start,
-  Update, Configure, Build, Test, Coverage, and Submit.
+ This option tells ctest to act as a Dart client and perform a
+ dashboard test.  All tests are <Mode><Test>, where Mode can be
+ Experimental, Nightly, and Continuous, and Test can be Start,
+ Update, Configure, Build, Test, Coverage, and Submit.
 
-* ``-D <var>:<type>=<value>``: Define a variable for script mode
+``-D <var>:<type>=<value>``
+ Define a variable for script mode
 
-  Pass in variable values on the command line.  Use in conjunction
-  with -S to pass variable values to a dashboard script.  Parsing -D
-  arguments as variable values is only attempted if the value
-  following -D does not match any of the known dashboard types.
+ Pass in variable values on the command line.  Use in conjunction
+ with -S to pass variable values to a dashboard script.  Parsing -D
+ arguments as variable values is only attempted if the value
+ following -D does not match any of the known dashboard types.
 
-* ``-M <model>, --test-model <model>``: Sets the model for a dashboard
+``-M <model>, --test-model <model>``
+ Sets the model for a dashboard
 
-  This option tells ctest to act as a Dart client where the TestModel
-  can be Experimental, Nightly, and Continuous.  Combining -M and -T
-  is similar to -D
+ This option tells ctest to act as a Dart client where the TestModel
+ can be Experimental, Nightly, and Continuous.  Combining -M and -T
+ is similar to -D
 
-* ``-T <action>, --test-action <action>``: Sets the dashboard action to perform
+``-T <action>, --test-action <action>``
+ Sets the dashboard action to perform
 
-  This option tells ctest to act as a Dart client and perform some
-  action such as start, build, test etc.  Combining -M and -T is
-  similar to -D
+ This option tells ctest to act as a Dart client and perform some
+ action such as start, build, test etc.  Combining -M and -T is
+ similar to -D
 
-* ``--track <track>``: Specify the track to submit dashboard to
+``--track <track>``
+ Specify the track to submit dashboard to
 
-  Submit dashboard to specified track instead of default one.  By
-  default, the dashboard is submitted to Nightly, Experimental, or
-  Continuous track, but by specifying this option, the track can be
-  arbitrary.
+ Submit dashboard to specified track instead of default one.  By
+ default, the dashboard is submitted to Nightly, Experimental, or
+ Continuous track, but by specifying this option, the track can be
+ arbitrary.
 
-* ``-S <script>, --script <script>``: Execute a dashboard for a configuration
+``-S <script>, --script <script>``
+ Execute a dashboard for a configuration
 
-  This option tells ctest to load in a configuration script which sets
-  a number of parameters such as the binary and source directories.
-  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
-  with the appropriate options.
+ This option tells ctest to load in a configuration script which sets
+ a number of parameters such as the binary and source directories.
+ 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
+ with the appropriate options.
 
-* ``-SP <script>, --script-new-process <script>``: Execute a dashboard for a configuration
+``-SP <script>, --script-new-process <script>``
+ Execute a dashboard for a configuration
 
-  This option does the same operations as -S but it will do them in a
-  separate process.  This is primarily useful in cases where the
-  script may modify the environment and you do not want the modified
-  environment to impact other -S scripts.
+ This option does the same operations as -S but it will do them in a
+ separate process.  This is primarily useful in cases where the
+ script may modify the environment and you do not want the modified
+ environment to impact other -S scripts.
 
-* ``-A <file>, --add-notes <file>``: Add a notes file with submission
+``-A <file>, --add-notes <file>``
+ Add a notes file with submission
 
-  This option tells ctest to include a notes file when submitting
-  dashboard.
+ This option tells ctest to include a notes file when submitting
+ dashboard.
 
-* ``-I [Start,End,Stride,test#,test#|Test file], --tests-information``: Run a specific number of tests by number.
+``-I [Start,End,Stride,test#,test#|Test file], --tests-information``
+ Run a specific number of tests by number.
 
-  This option causes ctest to run tests starting at number Start,
-  ending at number End, and incrementing by Stride.  Any additional
-  numbers after Stride are considered individual test numbers.  Start,
-  End,or stride can be empty.  Optionally a file can be given that
-  contains the same syntax as the command line.
+ This option causes ctest to run tests starting at number Start,
+ ending at number End, and incrementing by Stride.  Any additional
+ numbers after Stride are considered individual test numbers.  Start,
+ End,or stride can be empty.  Optionally a file can be given that
+ contains the same syntax as the command line.
 
-* ``-U, --union``: Take the Union of -I and -R
+``-U, --union``
+ Take the Union of -I and -R
 
-  When both -R and -I are specified by default the intersection of
-  tests are run.  By specifying -U the union of tests is run instead.
+ When both -R and -I are specified by default the intersection of
+ tests are run.  By specifying -U the union of tests is run instead.
 
-* ``--rerun-failed``: Run only the tests that failed previously
+``--rerun-failed``
+ Run only the tests that failed previously
 
-  This option tells ctest to perform only the tests that failed during
-  its previous run.  When this option is specified, ctest ignores all
-  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 fail,
-  subsequent calls to ctest with the --rerun-failed option will run
-  the set of tests that most recently failed (if any).
+ This option tells ctest to perform only the tests that failed during
+ its previous run.  When this option is specified, ctest ignores all
+ 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 fail,
+ subsequent calls to ctest with the --rerun-failed option will run
+ the set of tests that most recently failed (if any).
 
-* ``--max-width <width>``: Set the max width for a test name to output
+``--max-width <width>``
+ Set the max width for a test name to output
 
-  Set the maximum width for each test name to show in the output.
-  This allows the user to widen the output to avoid clipping the test
-  name which can be very annoying.
+ Set the maximum width for each test name to show in the output.
+ This allows the user to widen the output to avoid clipping the test
+ name which can be very annoying.
 
-* ``--interactive-debug-mode [0|1]``: Set the interactive mode to 0 or 1.
+``--interactive-debug-mode [0|1]``
+ Set the interactive mode to 0 or 1.
 
-  This option causes ctest to run tests in either an interactive mode
-  or a non-interactive mode.  On Windows this means that in
-  non-interactive mode, all system debug pop up windows are blocked.
-  In dashboard mode (Experimental, Nightly, Continuous), the default
-  is non-interactive.  When just running tests not for a dashboard the
-  default is to allow popups and interactive debugging.
+ This option causes ctest to run tests in either an interactive mode
+ or a non-interactive mode.  On Windows this means that in
+ non-interactive mode, all system debug pop up windows are blocked.
+ In dashboard mode (Experimental, Nightly, Continuous), the default
+ is non-interactive.  When just running tests not for a dashboard the
+ default is to allow popups and interactive debugging.
 
-* ``--no-label-summary``: Disable timing summary information for labels.
+``--no-label-summary``
+ Disable timing summary information for labels.
 
-  This option tells ctest not to print summary information for each
-  label associated with the tests run.  If there are no labels on the
-  tests, nothing extra is printed.
+ This option tells ctest not to print summary information for each
+ label associated with the tests run.  If there are no labels on the
+ tests, nothing extra is printed.
 
-* ``--build-and-test``: Configure, build and run a test.
+``--build-and-test``
+ Configure, build and run a test.
 
-  This option tells ctest to configure (i.e.  run cmake on), build,
-  and or execute a test.  The configure and test steps are optional.
-  The arguments to this command line are the source and binary
-  directories.  By default this will run CMake on the Source/Bin
-  directories specified unless --build-nocmake is specified.  Both
-  --build-makeprogram and --build-generator MUST be provided to use
-  --build-and-test.  If --test-command is specified then that will be
-  run after the build is complete.  Other options that affect this
-  mode are --build-target --build-nocmake, --build-run-dir,
-  --build-two-config, --build-exe-dir,
-  --build-project,--build-noclean, --build-options
+ This option tells ctest to configure (i.e.  run cmake on), build,
+ and or execute a test.  The configure and test steps are optional.
+ The arguments to this command line are the source and binary
+ directories.  By default this will run CMake on the Source/Bin
+ directories specified unless --build-nocmake is specified.  Both
+ --build-makeprogram and --build-generator MUST be provided to use
+ --build-and-test.  If --test-command is specified then that will be
+ run after the build is complete.  Other options that affect this
+ mode are --build-target --build-nocmake, --build-run-dir,
+ --build-two-config, --build-exe-dir,
+ --build-project,--build-noclean, --build-options
 
-* ``--build-target``: Specify a specific target to build.
+``--build-target``
+ Specify a specific target to build.
 
-  This option goes with the --build-and-test option, if left out the
-  all target is built.
+ This option goes with the --build-and-test option, if left out the
+ all target is built.
 
-* ``--build-nocmake``: Run the build without running cmake first.
+``--build-nocmake``
+ Run the build without running cmake first.
 
-  Skip the cmake step.
+ Skip the cmake step.
 
-* ``--build-run-dir``: Specify directory to run programs from.
+``--build-run-dir``
+ Specify directory to run programs from.
 
-  Directory where programs will be after it has been compiled.
+ Directory where programs will be after it has been compiled.
 
-* ``--build-two-config``: Run CMake twice
+``--build-two-config``
+ Run CMake twice
 
-* ``--build-exe-dir``: Specify the directory for the executable.
+``--build-exe-dir``
+ Specify the directory for the executable.
 
-* ``--build-generator``: Specify the generator to use.
+``--build-generator``
+ Specify the generator to use.
 
-* ``--build-generator-toolset``: Specify the generator-specific toolset.
+``--build-generator-toolset``
+ Specify the generator-specific toolset.
 
-* ``--build-project``: Specify the name of the project to build.
+``--build-project``
+ Specify the name of the project to build.
 
-* ``--build-makeprogram``: Specify the make program to use.
+``--build-makeprogram``
+ Specify the make program to use.
 
-* ``--build-noclean``: Skip the make clean step.
+``--build-noclean``
+ Skip the make clean step.
 
-* ``--build-config-sample``: A sample executable to use to determine the configuration
+``--build-config-sample``
+ A sample executable to use to determine the configuration
 
-  A sample executable to use to determine the configuration that
-  should be used.  e.g.  Debug/Release/etc
+ A sample executable to use to determine the configuration that
+ should be used.  e.g.  Debug/Release/etc
 
-* ``--build-options``: Add extra options to the build step.
+``--build-options``
+ Add extra options to the build step.
 
-  This option must be the last option with the exception of
-  --test-command
+ This option must be the last option with the exception of
+ --test-command
 
-* ``--test-command``: The test to run with the --build-and-test option.
+``--test-command``
+ The test to run with the --build-and-test option.
 
-* ``--test-timeout``: The time limit in seconds, internal use only.
+``--test-timeout``
+ The time limit in seconds, internal use only.
 
-* ``--tomorrow-tag``: Nightly or experimental starts with next day tag.
+``--tomorrow-tag``
+ Nightly or experimental starts with next day tag.
 
-  This is useful if the build will not finish in one day.
+ This is useful if the build will not finish in one day.
 
-* ``--ctest-config``: The configuration file used to initialize CTest state when submitting dashboards.
+``--ctest-config``
+ The configuration file used to initialize CTest state when submitting dashboards.
 
-  This option tells CTest to use different initialization file instead
-  of CTestConfiguration.tcl.  This way multiple initialization files
-  can be used for example to submit to multiple dashboards.
+ This option tells CTest to use different initialization file instead
+ of CTestConfiguration.tcl.  This way multiple initialization files
+ can be used for example to submit to multiple dashboards.
 
-* ``--overwrite``: Overwrite CTest configuration option.
+``--overwrite``
+ Overwrite CTest configuration option.
 
-  By default ctest uses configuration options from configuration file.
-  This option will overwrite the configuration option.
+ By default ctest uses configuration options from configuration file.
+ This option will overwrite the configuration option.
 
-* ``--extra-submit <file>[;<file>]``: Submit extra files to the dashboard.
+``--extra-submit <file>[;<file>]``
+ Submit extra files to the dashboard.
 
-  This option will submit extra files to the dashboard.
+ This option will submit extra files to the dashboard.
 
-* ``--force-new-ctest-process``: Run child CTest instances as new processes
+``--force-new-ctest-process``
+ Run child CTest instances as new processes
 
-  By default CTest will run child CTest instances within the same
-  process.  If this behavior is not desired, this argument will
-  enforce new processes for child CTest processes.
+ By default CTest will run child CTest instances within the same
+ process.  If this behavior is not desired, this argument will
+ enforce new processes for child CTest processes.
 
-* ``--schedule-random``: Use a random order for scheduling tests
+``--schedule-random``
+ Use a random order for scheduling tests
 
-  This option will run the tests in a random order.  It is commonly
-  used to detect implicit dependencies in a test suite.
+ This option will run the tests in a random order.  It is commonly
+ used to detect implicit dependencies in a test suite.
 
-* ``--submit-index``: Submit individual dashboard tests with specific index
+``--submit-index``
+ Submit individual dashboard tests with specific index
 
-  This option allows performing the same CTest action (such as test)
-  multiple times and submit all stages to the same dashboard (Dart2
-  required).  Each execution requires different index.
+ This option allows performing the same CTest action (such as test)
+ multiple times and submit all stages to the same dashboard (Dart2
+ required).  Each execution requires different index.
 
-* ``--timeout <seconds>``: Set a global timeout on all tests.
+``--timeout <seconds>``
+ Set a global timeout on all tests.
 
-  This option will set a global timeout on all tests that do not
-  already have a timeout set on them.
+ This option will set a global timeout on all tests that do not
+ already have a timeout set on them.
 
-* ``--stop-time <time>``: Set a time at which all tests should stop running.
+``--stop-time <time>``
+ Set a time at which all tests should stop running.
 
-  Set a real time of day at which all tests should timeout.  Example:
-  7:00:00 -0400.  Any time format understood by the curl date parser
-  is accepted.  Local time is assumed if no timezone is specified.
+ Set a real time of day at which all tests should timeout.  Example:
+ 7:00:00 -0400.  Any time format understood by the curl date parser
+ is accepted.  Local time is assumed if no timezone is specified.
 
-* ``--http1.0``: Submit using HTTP 1.0.
+``--http1.0``
+ Submit using HTTP 1.0.
 
-  This option will force CTest to use HTTP 1.0 to submit files to the
-  dashboard, instead of HTTP 1.1.
+ This option will force CTest to use HTTP 1.0 to submit files to the
+ dashboard, instead of HTTP 1.1.
 
-* ``--no-compress-output``: Do not compress test output when submitting.
+``--no-compress-output``
+ Do not compress test output when submitting.
 
-  This flag will turn off automatic compression of test output.  Use
-  this to maintain compatibility with an older version of CDash which
-  doesn't support compressed test output.
+ This flag will turn off automatic compression of test output.  Use
+ this to maintain compatibility with an older version of CDash which
+ doesn't support compressed test output.
 
-* ``--print-labels``: Print all available test labels.
+``--print-labels``
+ Print all available test labels.
 
-  This option will not run any tests, it will simply print the list of
-  all labels associated with the test set.
+ This option will not run any tests, it will simply print the list of
+ all labels associated with the test set.
 
 .. include:: OPTIONS_HELP.txt