Browse Source

Merge topic 'doc-ctest-variables'

34c6fd3a Help: Convert CTest Script variable references to cross-references
de710f37 Help: Add placeholder documents for CTest Script variables
Brad King 11 years ago
parent
commit
0ee116b7eb
47 changed files with 317 additions and 45 deletions
  1. 5 3
      Help/command/ctest_start.rst
  2. 51 0
      Help/manual/cmake-variables.7.rst
  3. 42 42
      Help/manual/ctest.1.rst
  4. 5 0
      Help/variable/CTEST_BINARY_DIRECTORY.rst
  5. 5 0
      Help/variable/CTEST_BUILD_COMMAND.rst
  6. 5 0
      Help/variable/CTEST_BUILD_NAME.rst
  7. 5 0
      Help/variable/CTEST_BZR_COMMAND.rst
  8. 5 0
      Help/variable/CTEST_BZR_UPDATE_OPTIONS.rst
  9. 5 0
      Help/variable/CTEST_CHECKOUT_COMMAND.rst
  10. 5 0
      Help/variable/CTEST_CONFIGURATION_TYPE.rst
  11. 5 0
      Help/variable/CTEST_CONFIGURE_COMMAND.rst
  12. 5 0
      Help/variable/CTEST_COVERAGE_COMMAND.rst
  13. 5 0
      Help/variable/CTEST_COVERAGE_EXTRA_FLAGS.rst
  14. 5 0
      Help/variable/CTEST_CURL_OPTIONS.rst
  15. 4 0
      Help/variable/CTEST_CVS_CHECKOUT.rst
  16. 5 0
      Help/variable/CTEST_CVS_COMMAND.rst
  17. 5 0
      Help/variable/CTEST_CVS_UPDATE_OPTIONS.rst
  18. 5 0
      Help/variable/CTEST_DROP_LOCATION.rst
  19. 5 0
      Help/variable/CTEST_DROP_METHOD.rst
  20. 5 0
      Help/variable/CTEST_DROP_SITE.rst
  21. 5 0
      Help/variable/CTEST_DROP_SITE_CDASH.rst
  22. 5 0
      Help/variable/CTEST_DROP_SITE_PASSWORD.rst
  23. 5 0
      Help/variable/CTEST_DROP_SITE_USER.rst
  24. 5 0
      Help/variable/CTEST_GIT_COMMAND.rst
  25. 5 0
      Help/variable/CTEST_GIT_UPDATE_CUSTOM.rst
  26. 5 0
      Help/variable/CTEST_GIT_UPDATE_OPTIONS.rst
  27. 5 0
      Help/variable/CTEST_HG_COMMAND.rst
  28. 5 0
      Help/variable/CTEST_HG_UPDATE_OPTIONS.rst
  29. 5 0
      Help/variable/CTEST_MEMORYCHECK_COMMAND.rst
  30. 5 0
      Help/variable/CTEST_MEMORYCHECK_COMMAND_OPTIONS.rst
  31. 5 0
      Help/variable/CTEST_MEMORYCHECK_SUPPRESSIONS_FILE.rst
  32. 5 0
      Help/variable/CTEST_NIGHTLY_START_TIME.rst
  33. 5 0
      Help/variable/CTEST_P4_CLIENT.rst
  34. 5 0
      Help/variable/CTEST_P4_COMMAND.rst
  35. 5 0
      Help/variable/CTEST_P4_OPTIONS.rst
  36. 5 0
      Help/variable/CTEST_P4_UPDATE_OPTIONS.rst
  37. 5 0
      Help/variable/CTEST_SCP_COMMAND.rst
  38. 5 0
      Help/variable/CTEST_SITE.rst
  39. 5 0
      Help/variable/CTEST_SOURCE_DIRECTORY.rst
  40. 5 0
      Help/variable/CTEST_SVN_COMMAND.rst
  41. 5 0
      Help/variable/CTEST_SVN_OPTIONS.rst
  42. 5 0
      Help/variable/CTEST_SVN_UPDATE_OPTIONS.rst
  43. 5 0
      Help/variable/CTEST_TEST_TIMEOUT.rst
  44. 5 0
      Help/variable/CTEST_TRIGGER_SITE.rst
  45. 5 0
      Help/variable/CTEST_UPDATE_COMMAND.rst
  46. 5 0
      Help/variable/CTEST_UPDATE_OPTIONS.rst
  47. 5 0
      Help/variable/CTEST_USE_LAUNCHERS.rst

+ 5 - 3
Help/command/ctest_start.rst

@@ -10,13 +10,15 @@ Starts the testing for a given model
 Starts the testing for a given model.  The command should be called
 after the binary directory is initialized.  If the 'source' and
 'binary' directory are not specified, it reads the
-CTEST_SOURCE_DIRECTORY and CTEST_BINARY_DIRECTORY.  If the track is
+:variable:`CTEST_SOURCE_DIRECTORY` and :variable:`CTEST_BINARY_DIRECTORY`.
+If the track is
 specified, the submissions will go to the specified track.  If APPEND
 is used, the existing TAG is used rather than creating a new one based
 on the current time stamp.
 
-If the ``CTEST_CHECKOUT_COMMAND`` variable (or the ``CTEST_CVS_CHECKOUT``
-variable) is set, its content is treated as command-line.  The command is
+If the :variable:`CTEST_CHECKOUT_COMMAND` variable
+(or the :variable:`CTEST_CVS_CHECKOUT` variable)
+is set, its content is treated as command-line.  The command is
 invoked with the current working directory set to the parent of the source
 directory, even if the source directory already exists.  This can be used
 to create the source tree from a version control repository.

+ 51 - 0
Help/manual/cmake-variables.7.rst

@@ -308,6 +308,57 @@ Variables for Languages
    /variable/CMAKE_LANG_SOURCE_FILE_EXTENSIONS
    /variable/CMAKE_USER_MAKE_RULES_OVERRIDE_LANG
 
+Variables for CTest
+===================
+
+.. toctree::
+   :maxdepth: 1
+
+   /variable/CTEST_BINARY_DIRECTORY
+   /variable/CTEST_BUILD_COMMAND
+   /variable/CTEST_BUILD_NAME
+   /variable/CTEST_BZR_COMMAND
+   /variable/CTEST_BZR_UPDATE_OPTIONS
+   /variable/CTEST_CHECKOUT_COMMAND
+   /variable/CTEST_CONFIGURATION_TYPE
+   /variable/CTEST_CONFIGURE_COMMAND
+   /variable/CTEST_COVERAGE_COMMAND
+   /variable/CTEST_COVERAGE_EXTRA_FLAGS
+   /variable/CTEST_CURL_OPTIONS
+   /variable/CTEST_CVS_CHECKOUT
+   /variable/CTEST_CVS_COMMAND
+   /variable/CTEST_CVS_UPDATE_OPTIONS
+   /variable/CTEST_DROP_LOCATION
+   /variable/CTEST_DROP_METHOD
+   /variable/CTEST_DROP_SITE
+   /variable/CTEST_DROP_SITE_CDASH
+   /variable/CTEST_DROP_SITE_PASSWORD
+   /variable/CTEST_DROP_SITE_USER
+   /variable/CTEST_GIT_COMMAND
+   /variable/CTEST_GIT_UPDATE_CUSTOM
+   /variable/CTEST_GIT_UPDATE_OPTIONS
+   /variable/CTEST_HG_COMMAND
+   /variable/CTEST_HG_UPDATE_OPTIONS
+   /variable/CTEST_MEMORYCHECK_COMMAND
+   /variable/CTEST_MEMORYCHECK_COMMAND_OPTIONS
+   /variable/CTEST_MEMORYCHECK_SUPPRESSIONS_FILE
+   /variable/CTEST_NIGHTLY_START_TIME
+   /variable/CTEST_P4_CLIENT
+   /variable/CTEST_P4_COMMAND
+   /variable/CTEST_P4_OPTIONS
+   /variable/CTEST_P4_UPDATE_OPTIONS
+   /variable/CTEST_SCP_COMMAND
+   /variable/CTEST_SITE
+   /variable/CTEST_SOURCE_DIRECTORY
+   /variable/CTEST_SVN_COMMAND
+   /variable/CTEST_SVN_OPTIONS
+   /variable/CTEST_SVN_UPDATE_OPTIONS
+   /variable/CTEST_TEST_TIMEOUT
+   /variable/CTEST_TRIGGER_SITE
+   /variable/CTEST_UPDATE_COMMAND
+   /variable/CTEST_UPDATE_OPTIONS
+   /variable/CTEST_USE_LAUNCHERS
+
 Variables for CPack
 ===================
 

+ 42 - 42
Help/manual/ctest.1.rst

@@ -518,13 +518,13 @@ Configuration settings include:
 ``BuildDirectory``
   The full path to the project build tree.
 
-  * `CTest Script`_ variable: ``CTEST_BINARY_DIRECTORY``
+  * `CTest Script`_ variable: :variable:`CTEST_BINARY_DIRECTORY`
   * :module:`CTest` module variable: :variable:`PROJECT_BINARY_DIR`
 
 ``SourceDirectory``
   The full path to the project source tree.
 
-  * `CTest Script`_ variable: ``CTEST_SOURCE_DIRECTORY``
+  * `CTest Script`_ variable: :variable:`CTEST_SOURCE_DIRECTORY`
   * :module:`CTest` module variable: :variable:`PROJECT_SOURCE_DIR`
 
 .. _`CTest Update Step`:
@@ -540,31 +540,31 @@ Configuration settings to specify the version control tool include:
 ``BZRCommand``
   ``bzr`` command-line tool to use if source tree is managed by Bazaar.
 
-  * `CTest Script`_ variable: ``CTEST_BZR_COMMAND``
+  * `CTest Script`_ variable: :variable:`CTEST_BZR_COMMAND`
   * :module:`CTest` module variable: none
 
 ``BZRUpdateOptions``
   Command-line options to the ``BZRCommand`` when updating the source.
 
-  * `CTest Script`_ variable: ``CTEST_BZR_UPDATE_OPTIONS``
+  * `CTest Script`_ variable: :variable:`CTEST_BZR_UPDATE_OPTIONS`
   * :module:`CTest` module variable: none
 
 ``CVSCommand``
   ``cvs`` command-line tool to use if source tree is managed by CVS.
 
-  * `CTest Script`_ variable: ``CTEST_CVS_COMMAND``
+  * `CTest Script`_ variable: :variable:`CTEST_CVS_COMMAND`
   * :module:`CTest` module variable: ``CVSCOMMAND``
 
 ``CVSUpdateOptions``
   Command-line options to the ``CVSCommand`` when updating the source.
 
-  * `CTest Script`_ variable: ``CTEST_CVS_UPDATE_OPTIONS``
+  * `CTest Script`_ variable: :variable:`CTEST_CVS_UPDATE_OPTIONS`
   * :module:`CTest` module variable: ``CVS_UPDATE_OPTIONS``
 
 ``GITCommand``
   ``git`` command-line tool to use if source tree is managed by Git.
 
-  * `CTest Script`_ variable: ``CTEST_GIT_COMMAND``
+  * `CTest Script`_ variable: :variable:`CTEST_GIT_COMMAND`
   * :module:`CTest` module variable: ``GITCOMMAND``
 
 ``GITUpdateCustom``
@@ -572,43 +572,43 @@ Configuration settings to specify the version control tool include:
   in the source tree (Git work tree) to update it instead of running
   the ``GITCommand``.
 
-  * `CTest Script`_ variable: ``CTEST_GIT_UPDATE_CUSTOM``
+  * `CTest Script`_ variable: :variable:`CTEST_GIT_UPDATE_CUSTOM`
   * :module:`CTest` module variable: ``CTEST_GIT_UPDATE_CUSTOM``
 
 ``GITUpdateOptions``
   Command-line options to the ``GITCommand`` when updating the source.
 
-  * `CTest Script`_ variable: ``CTEST_GIT_UPDATE_OPTIONS``
+  * `CTest Script`_ variable: :variable:`CTEST_GIT_UPDATE_OPTIONS`
   * :module:`CTest` module variable: ``GIT_UPDATE_OPTIONS``
 
 ``HGCommand``
   ``hg`` command-line tool to use if source tree is managed by Mercurial.
 
-  * `CTest Script`_ variable: ``CTEST_HG_COMMAND``
+  * `CTest Script`_ variable: :variable:`CTEST_HG_COMMAND`
   * :module:`CTest` module variable: none
 
 ``HGUpdateOptions``
   Command-line options to the ``HGCommand`` when updating the source.
 
-  * `CTest Script`_ variable: ``CTEST_HG_UPDATE_OPTIONS``
+  * `CTest Script`_ variable: :variable:`CTEST_HG_UPDATE_OPTIONS`
   * :module:`CTest` module variable: none
 
 ``P4Client``
   Value of the ``-c`` option to the ``P4Command``.
 
-  * `CTest Script`_ variable: ``CTEST_P4_CLIENT``
+  * `CTest Script`_ variable: :variable:`CTEST_P4_CLIENT`
   * :module:`CTest` module variable: ``CTEST_P4_CLIENT``
 
 ``P4Command``
   ``p4`` command-line tool to use if source tree is managed by Perforce.
 
-  * `CTest Script`_ variable: ``CTEST_P4_COMMAND``
+  * `CTest Script`_ variable: :variable:`CTEST_P4_COMMAND`
   * :module:`CTest` module variable: ``P4COMMAND``
 
 ``P4Options``
   Command-line options to the ``P4Command`` for all invocations.
 
-  * `CTest Script`_ variable: ``CTEST_P4_OPTIONS``
+  * `CTest Script`_ variable: :variable:`CTEST_P4_OPTIONS`
   * :module:`CTest` module variable: ``CTEST_P4_OPTIONS``
 
 ``P4UpdateCustom``
@@ -622,39 +622,39 @@ Configuration settings to specify the version control tool include:
 ``P4UpdateOptions``
   Command-line options to the ``P4Command`` when updating the source.
 
-  * `CTest Script`_ variable: ``CTEST_P4_UPDATE_OPTIONS``
+  * `CTest Script`_ variable: :variable:`CTEST_P4_UPDATE_OPTIONS`
   * :module:`CTest` module variable: ``CTEST_P4_UPDATE_OPTIONS``
 
 ``SVNCommand``
   ``svn`` command-line tool to use if source tree is managed by Subversion.
 
-  * `CTest Script`_ variable: ``CTEST_SVN_COMMAND``
+  * `CTest Script`_ variable: :variable:`CTEST_SVN_COMMAND`
   * :module:`CTest` module variable: ``SVNCOMMAND``
 
 ``SVNOptions``
   Command-line options to the ``SVNCommand`` for all invocations.
 
-  * `CTest Script`_ variable: ``CTEST_SVN_OPTIONS``
+  * `CTest Script`_ variable: :variable:`CTEST_SVN_OPTIONS`
   * :module:`CTest` module variable: ``CTEST_SVN_OPTIONS``
 
 ``SVNUpdateOptions``
   Command-line options to the ``SVNCommand`` when updating the source.
 
-  * `CTest Script`_ variable: ``CTEST_SVN_UPDATE_OPTIONS``
+  * `CTest Script`_ variable: :variable:`CTEST_SVN_UPDATE_OPTIONS`
   * :module:`CTest` module variable: ``SVN_UPDATE_OPTIONS``
 
 ``UpdateCommand``
   Specify the version-control command-line tool to use without
   detecting the VCS that manages the source tree.
 
-  * `CTest Script`_ variable: ``CTEST_UPDATE_COMMAND``
+  * `CTest Script`_ variable: :variable:`CTEST_UPDATE_COMMAND`
   * :module:`CTest` module variable: ``<VCS>COMMAND``
     when ``UPDATE_TYPE`` is ``<vcs>``, else ``UPDATE_COMMAND``
 
 ``UpdateOptions``
   Command-line options to the ``UpdateCommand``.
 
-  * `CTest Script`_ variable: ``CTEST_UPDATE_OPTIONS``
+  * `CTest Script`_ variable: :variable:`CTEST_UPDATE_OPTIONS`
   * :module:`CTest` module variable: ``<VCS>_UPDATE_OPTIONS``
     when ``UPDATE_TYPE`` is ``<vcs>``, else ``UPDATE_OPTIONS``
 
@@ -678,7 +678,7 @@ Additional configuration settings include:
   This is not well-defined in distributed version-control systems so
   the setting is ignored.
 
-  * `CTest Script`_ variable: ``CTEST_NIGHTLY_START_TIME``
+  * `CTest Script`_ variable: :variable:`CTEST_NIGHTLY_START_TIME`
   * :module:`CTest` module variable: ``NIGHTLY_START_TIME`` if set,
     else ``CTEST_NIGHTLY_START_TIME``
 
@@ -697,7 +697,7 @@ Configuration settings include:
   It will be executed in the location specified by the
   ``BuildDirectory`` setting.
 
-  * `CTest Script`_ variable: ``CTEST_CONFIGURE_COMMAND``
+  * `CTest Script`_ variable: :variable:`CTEST_CONFIGURE_COMMAND`
   * :module:`CTest` module variable: :variable:`CMAKE_COMMAND`
     followed by :variable:`PROJECT_SOURCE_DIR`
 
@@ -719,7 +719,7 @@ Configuration settings include:
   the value of ``MakeCommand`` to replace the literal string
   ``${CTEST_CONFIGURATION_TYPE}`` if it appears.
 
-  * `CTest Script`_ variable: ``CTEST_CONFIGURATION_TYPE``
+  * `CTest Script`_ variable: :variable:`CTEST_CONFIGURATION_TYPE`
   * :module:`CTest` module variable: ``DEFAULT_CTEST_CONFIGURATION_TYPE``,
     initialized by the ``CMAKE_CONFIG_TYPE`` environment variable
 
@@ -728,7 +728,7 @@ Configuration settings include:
   It will be executed in the location specified by the
   ``BuildDirectory`` setting.
 
-  * `CTest Script`_ variable: ``CTEST_BUILD_COMMAND``
+  * `CTest Script`_ variable: :variable:`CTEST_BUILD_COMMAND`
   * :module:`CTest` module variable: ``MAKECOMMAND``,
     initialized by the :command:`build_command` command
 
@@ -744,7 +744,7 @@ Configuration settings include:
   granular build warning and error information.  Otherwise,
   CTest must "scrape" the build output log for diagnostics.
 
-  * `CTest Script`_ variable: ``CTEST_USE_LAUNCHERS``
+  * `CTest Script`_ variable: :variable:`CTEST_USE_LAUNCHERS`
   * :module:`CTest` module variable: ``CTEST_USE_LAUNCHERS``
 
 .. _`CTest Test Step`:
@@ -761,7 +761,7 @@ Configuration settings include:
   The default timeout for each test if not specified by the
   :prop_test:`TIMEOUT` test property.
 
-  * `CTest Script`_ variable: ``CTEST_TEST_TIMEOUT``
+  * `CTest Script`_ variable: :variable:`CTEST_TEST_TIMEOUT`
   * :module:`CTest` module variable: ``DART_TESTING_TIMEOUT``
 
 .. _`CTest Coverage Step`:
@@ -779,13 +779,13 @@ Configuration settings include:
   It will be executed in the location specified by the
   ``BuildDirectory`` setting.
 
-  * `CTest Script`_ variable: ``CTEST_COVERAGE_COMMAND``
+  * `CTest Script`_ variable: :variable:`CTEST_COVERAGE_COMMAND`
   * :module:`CTest` module variable: ``COVERAGE_COMMAND``
 
 ``CoverageExtraFlags``
   Specify command-line options to the ``CoverageCommand`` tool.
 
-  * `CTest Script`_ variable: ``CTEST_COVERAGE_EXTRA_FLAGS``
+  * `CTest Script`_ variable: :variable:`CTEST_COVERAGE_EXTRA_FLAGS`
   * :module:`CTest` module variable: ``COVERAGE_EXTRA_FLAGS``
 
 .. _`CTest MemCheck Step`:
@@ -802,14 +802,14 @@ Configuration settings include:
   Command-line tool to perform dynamic analysis.  Test command lines
   will be launched through this tool.
 
-  * `CTest Script`_ variable: ``CTEST_MEMORYCHECK_COMMAND``
+  * `CTest Script`_ variable: :variable:`CTEST_MEMORYCHECK_COMMAND`
   * :module:`CTest` module variable: ``MEMORYCHECK_COMMAND``
 
 ``MemoryCheckCommandOptions``
   Specify command-line options to the ``MemoryCheckCommand`` tool.
   They will be placed prior to the test command line.
 
-  * `CTest Script`_ variable: ``CTEST_MEMORYCHECK_COMMAND_OPTIONS``
+  * `CTest Script`_ variable: :variable:`CTEST_MEMORYCHECK_COMMAND_OPTIONS`
   * :module:`CTest` module variable: ``MEMORYCHECK_COMMAND_OPTIONS``
 
 ``MemoryCheckSuppressionFile``
@@ -817,7 +817,7 @@ Configuration settings include:
   ``MemoryCheckCommand`` tool.  It will be passed with options
   appropriate to the tool.
 
-  * `CTest Script`_ variable: ``CTEST_MEMORYCHECK_SUPPRESSIONS_FILE``
+  * `CTest Script`_ variable: :variable:`CTEST_MEMORYCHECK_SUPPRESSIONS_FILE`
   * :module:`CTest` module variable: ``MEMORYCHECK_SUPPRESSIONS_FILE``
 
 Additional configuration settings include:
@@ -864,7 +864,7 @@ Configuration settings include:
   Describe the dashboard client platform with a short string.
   (Operating system, compiler, etc.)
 
-  * `CTest Script`_ variable: ``CTEST_BUILD_NAME``
+  * `CTest Script`_ variable: :variable:`CTEST_BUILD_NAME`
   * :module:`CTest` module variable: ``BUILDNAME``
 
 ``CDashVersion``
@@ -893,13 +893,13 @@ Configuration settings include:
   server.  Possible options are ``CURLOPT_SSL_VERIFYPEER_OFF``
   and ``CURLOPT_SSL_VERIFYHOST_OFF``.
 
-  * `CTest Script`_ variable: ``CTEST_CURL_OPTIONS``
+  * `CTest Script`_ variable: :variable:`CTEST_CURL_OPTIONS`
   * :module:`CTest` module variable: ``CTEST_CURL_OPTIONS``
 
 ``DropLocation``
   The path on the dashboard server to send the submission.
 
-  * `CTest Script`_ variable: ``CTEST_DROP_LOCATION``
+  * `CTest Script`_ variable: :variable:`CTEST_DROP_LOCATION`
   * :module:`CTest` module variable: ``DROP_LOCATION`` if set,
     else ``CTEST_DROP_LOCATION``
 
@@ -909,7 +909,7 @@ Configuration settings include:
   ``https``, ``scp``, or ``xmlrpc`` (if CMake was built with
   support for it).
 
-  * `CTest Script`_ variable: ``CTEST_DROP_METHOD``
+  * `CTest Script`_ variable: :variable:`CTEST_DROP_METHOD`
   * :module:`CTest` module variable: ``DROP_METHOD`` if set,
     else ``CTEST_DROP_METHOD``
 
@@ -917,7 +917,7 @@ Configuration settings include:
   The dashboard server name
   (for ``ftp``, ``http``, and ``https``, ``scp``, and ``xmlrpc``).
 
-  * `CTest Script`_ variable: ``CTEST_DROP_SITE``
+  * `CTest Script`_ variable: :variable:`CTEST_DROP_SITE`
   * :module:`CTest` module variable: ``DROP_SITE`` if set,
     else ``CTEST_DROP_SITE``
 
@@ -925,7 +925,7 @@ Configuration settings include:
   The dashboard server login password, if any
   (for ``ftp``, ``http``, and ``https``).
 
-  * `CTest Script`_ variable: ``CTEST_DROP_SITE_PASSWORD``
+  * `CTest Script`_ variable: :variable:`CTEST_DROP_SITE_PASSWORD`
   * :module:`CTest` module variable: ``DROP_SITE_PASSWORD`` if set,
     else ``CTEST_DROP_SITE_PASWORD``
 
@@ -933,7 +933,7 @@ Configuration settings include:
   The dashboard server login user name, if any
   (for ``ftp``, ``http``, and ``https``).
 
-  * `CTest Script`_ variable: ``CTEST_DROP_SITE_USER``
+  * `CTest Script`_ variable: :variable:`CTEST_DROP_SITE_USER`
   * :module:`CTest` module variable: ``DROP_SITE_USER`` if set,
     else ``CTEST_DROP_SITE_USER``
 
@@ -941,20 +941,20 @@ Configuration settings include:
   Specify whether the dashboard server is `CDash`_ or an older
   dashboard server implementation requiring ``TriggerSite``.
 
-  * `CTest Script`_ variable: ``CTEST_DROP_SITE_CDASH``
+  * `CTest Script`_ variable: :variable:`CTEST_DROP_SITE_CDASH`
   * :module:`CTest` module variable: ``CTEST_DROP_SITE_CDASH``
 
 ``ScpCommand``
   ``scp`` command-line tool to use when ``DropMethod`` is ``scp``.
 
-  * `CTest Script`_ variable: ``CTEST_SCP_COMMAND``
+  * `CTest Script`_ variable: :variable:`CTEST_SCP_COMMAND`
   * :module:`CTest` module variable: ``SCPCOMMAND``
 
 ``Site``
   Describe the dashboard client host site with a short string.
   (Hostname, domain, etc.)
 
-  * `CTest Script`_ variable: ``CTEST_SITE``
+  * `CTest Script`_ variable: :variable:`CTEST_SITE`
   * :module:`CTest` module variable: ``SITE``,
     initialized by the :command:`site_name` command
 
@@ -962,7 +962,7 @@ Configuration settings include:
   Legacy option to support older dashboard server implementations.
   Not used when ``IsCDash`` is true.
 
-  * `CTest Script`_ variable: ``CTEST_TRIGGER_SITE``
+  * `CTest Script`_ variable: :variable:`CTEST_TRIGGER_SITE`
   * :module:`CTest` module variable: ``TRIGGER_SITE`` if set,
     else ``CTEST_TRIGGER_SITE``
 

+ 5 - 0
Help/variable/CTEST_BINARY_DIRECTORY.rst

@@ -0,0 +1,5 @@
+CTEST_BINARY_DIRECTORY
+----------------------
+
+Specify the CTest ``BuildDirectory`` setting
+in a :manual:`ctest(1)` dashboard client script.

+ 5 - 0
Help/variable/CTEST_BUILD_COMMAND.rst

@@ -0,0 +1,5 @@
+CTEST_BUILD_COMMAND
+-------------------
+
+Specify the CTest ``MakeCommand`` setting
+in a :manual:`ctest(1)` dashboard client script.

+ 5 - 0
Help/variable/CTEST_BUILD_NAME.rst

@@ -0,0 +1,5 @@
+CTEST_BUILD_NAME
+----------------
+
+Specify the CTest ``BuildName`` setting
+in a :manual:`ctest(1)` dashboard client script.

+ 5 - 0
Help/variable/CTEST_BZR_COMMAND.rst

@@ -0,0 +1,5 @@
+CTEST_BZR_COMMAND
+-----------------
+
+Specify the CTest ``BZRCommand`` setting
+in a :manual:`ctest(1)` dashboard client script.

+ 5 - 0
Help/variable/CTEST_BZR_UPDATE_OPTIONS.rst

@@ -0,0 +1,5 @@
+CTEST_BZR_UPDATE_OPTIONS
+------------------------
+
+Specify the CTest ``BZRUpdateOptions`` setting
+in a :manual:`ctest(1)` dashboard client script.

+ 5 - 0
Help/variable/CTEST_CHECKOUT_COMMAND.rst

@@ -0,0 +1,5 @@
+CTEST_CHECKOUT_COMMAND
+----------------------
+
+Tell the :command:`ctest_start` command how to checkout or initialize
+the source directory in a :manual:`ctest(1)` dashboard client script.

+ 5 - 0
Help/variable/CTEST_CONFIGURATION_TYPE.rst

@@ -0,0 +1,5 @@
+CTEST_CONFIGURATION_TYPE
+------------------------
+
+Specify the CTest ``DefaultCTestConfigurationType`` setting
+in a :manual:`ctest(1)` dashboard client script.

+ 5 - 0
Help/variable/CTEST_CONFIGURE_COMMAND.rst

@@ -0,0 +1,5 @@
+CTEST_CONFIGURE_COMMAND
+-----------------------
+
+Specify the CTest ``ConfigureCommand`` setting
+in a :manual:`ctest(1)` dashboard client script.

+ 5 - 0
Help/variable/CTEST_COVERAGE_COMMAND.rst

@@ -0,0 +1,5 @@
+CTEST_COVERAGE_COMMAND
+----------------------
+
+Specify the CTest ``CoverageCommand`` setting
+in a :manual:`ctest(1)` dashboard client script.

+ 5 - 0
Help/variable/CTEST_COVERAGE_EXTRA_FLAGS.rst

@@ -0,0 +1,5 @@
+CTEST_COVERAGE_EXTRA_FLAGS
+--------------------------
+
+Specify the CTest ``CoverageExtraFlags`` setting
+in a :manual:`ctest(1)` dashboard client script.

+ 5 - 0
Help/variable/CTEST_CURL_OPTIONS.rst

@@ -0,0 +1,5 @@
+CTEST_CURL_OPTIONS
+------------------
+
+Specify the CTest ``CurlOptions`` setting
+in a :manual:`ctest(1)` dashboard client script.

+ 4 - 0
Help/variable/CTEST_CVS_CHECKOUT.rst

@@ -0,0 +1,4 @@
+CTEST_CVS_CHECKOUT
+------------------
+
+Deprecated.  Use :variable:`CTEST_CHECKOUT_COMMAND` instead.

+ 5 - 0
Help/variable/CTEST_CVS_COMMAND.rst

@@ -0,0 +1,5 @@
+CTEST_CVS_COMMAND
+-----------------
+
+Specify the CTest ``CVSCommand`` setting
+in a :manual:`ctest(1)` dashboard client script.

+ 5 - 0
Help/variable/CTEST_CVS_UPDATE_OPTIONS.rst

@@ -0,0 +1,5 @@
+CTEST_CVS_UPDATE_OPTIONS
+------------------------
+
+Specify the CTest ``CVSUpdateOptions`` setting
+in a :manual:`ctest(1)` dashboard client script.

+ 5 - 0
Help/variable/CTEST_DROP_LOCATION.rst

@@ -0,0 +1,5 @@
+CTEST_DROP_LOCATION
+-------------------
+
+Specify the CTest ``DropLocation`` setting
+in a :manual:`ctest(1)` dashboard client script.

+ 5 - 0
Help/variable/CTEST_DROP_METHOD.rst

@@ -0,0 +1,5 @@
+CTEST_DROP_METHOD
+-----------------
+
+Specify the CTest ``DropMethod`` setting
+in a :manual:`ctest(1)` dashboard client script.

+ 5 - 0
Help/variable/CTEST_DROP_SITE.rst

@@ -0,0 +1,5 @@
+CTEST_DROP_SITE
+---------------
+
+Specify the CTest ``DropSite`` setting
+in a :manual:`ctest(1)` dashboard client script.

+ 5 - 0
Help/variable/CTEST_DROP_SITE_CDASH.rst

@@ -0,0 +1,5 @@
+CTEST_DROP_SITE_CDASH
+---------------------
+
+Specify the CTest ``IsCDash`` setting
+in a :manual:`ctest(1)` dashboard client script.

+ 5 - 0
Help/variable/CTEST_DROP_SITE_PASSWORD.rst

@@ -0,0 +1,5 @@
+CTEST_DROP_SITE_PASSWORD
+------------------------
+
+Specify the CTest ``DropSitePassword`` setting
+in a :manual:`ctest(1)` dashboard client script.

+ 5 - 0
Help/variable/CTEST_DROP_SITE_USER.rst

@@ -0,0 +1,5 @@
+CTEST_DROP_SITE_USER
+--------------------
+
+Specify the CTest ``DropSiteUser`` setting
+in a :manual:`ctest(1)` dashboard client script.

+ 5 - 0
Help/variable/CTEST_GIT_COMMAND.rst

@@ -0,0 +1,5 @@
+CTEST_GIT_COMMAND
+-----------------
+
+Specify the CTest ``GITCommand`` setting
+in a :manual:`ctest(1)` dashboard client script.

+ 5 - 0
Help/variable/CTEST_GIT_UPDATE_CUSTOM.rst

@@ -0,0 +1,5 @@
+CTEST_GIT_UPDATE_CUSTOM
+-----------------------
+
+Specify the CTest ``GITUpdateCustom`` setting
+in a :manual:`ctest(1)` dashboard client script.

+ 5 - 0
Help/variable/CTEST_GIT_UPDATE_OPTIONS.rst

@@ -0,0 +1,5 @@
+CTEST_GIT_UPDATE_OPTIONS
+------------------------
+
+Specify the CTest ``GITUpdateOptions`` setting
+in a :manual:`ctest(1)` dashboard client script.

+ 5 - 0
Help/variable/CTEST_HG_COMMAND.rst

@@ -0,0 +1,5 @@
+CTEST_HG_COMMAND
+----------------
+
+Specify the CTest ``HGCommand`` setting
+in a :manual:`ctest(1)` dashboard client script.

+ 5 - 0
Help/variable/CTEST_HG_UPDATE_OPTIONS.rst

@@ -0,0 +1,5 @@
+CTEST_HG_UPDATE_OPTIONS
+-----------------------
+
+Specify the CTest ``HGUpdateOptions`` setting
+in a :manual:`ctest(1)` dashboard client script.

+ 5 - 0
Help/variable/CTEST_MEMORYCHECK_COMMAND.rst

@@ -0,0 +1,5 @@
+CTEST_MEMORYCHECK_COMMAND
+-------------------------
+
+Specify the CTest ``MemoryCheckCommand`` setting
+in a :manual:`ctest(1)` dashboard client script.

+ 5 - 0
Help/variable/CTEST_MEMORYCHECK_COMMAND_OPTIONS.rst

@@ -0,0 +1,5 @@
+CTEST_MEMORYCHECK_COMMAND_OPTIONS
+---------------------------------
+
+Specify the CTest ``MemoryCheckCommandOptions`` setting
+in a :manual:`ctest(1)` dashboard client script.

+ 5 - 0
Help/variable/CTEST_MEMORYCHECK_SUPPRESSIONS_FILE.rst

@@ -0,0 +1,5 @@
+CTEST_MEMORYCHECK_SUPPRESSIONS_FILE
+-----------------------------------
+
+Specify the CTest ``MemoryCheckSuppressionFile`` setting
+in a :manual:`ctest(1)` dashboard client script.

+ 5 - 0
Help/variable/CTEST_NIGHTLY_START_TIME.rst

@@ -0,0 +1,5 @@
+CTEST_NIGHTLY_START_TIME
+------------------------
+
+Specify the CTest ``NightlyStartTime`` setting
+in a :manual:`ctest(1)` dashboard client script.

+ 5 - 0
Help/variable/CTEST_P4_CLIENT.rst

@@ -0,0 +1,5 @@
+CTEST_P4_CLIENT
+---------------
+
+Specify the CTest ``P4Client`` setting
+in a :manual:`ctest(1)` dashboard client script.

+ 5 - 0
Help/variable/CTEST_P4_COMMAND.rst

@@ -0,0 +1,5 @@
+CTEST_P4_COMMAND
+----------------
+
+Specify the CTest ``P4Command`` setting
+in a :manual:`ctest(1)` dashboard client script.

+ 5 - 0
Help/variable/CTEST_P4_OPTIONS.rst

@@ -0,0 +1,5 @@
+CTEST_P4_OPTIONS
+----------------
+
+Specify the CTest ``P4Options`` setting
+in a :manual:`ctest(1)` dashboard client script.

+ 5 - 0
Help/variable/CTEST_P4_UPDATE_OPTIONS.rst

@@ -0,0 +1,5 @@
+CTEST_P4_UPDATE_OPTIONS
+-----------------------
+
+Specify the CTest ``P4UpdateOptions`` setting
+in a :manual:`ctest(1)` dashboard client script.

+ 5 - 0
Help/variable/CTEST_SCP_COMMAND.rst

@@ -0,0 +1,5 @@
+CTEST_SCP_COMMAND
+-----------------
+
+Specify the CTest ``SCPCommand`` setting
+in a :manual:`ctest(1)` dashboard client script.

+ 5 - 0
Help/variable/CTEST_SITE.rst

@@ -0,0 +1,5 @@
+CTEST_SITE
+----------
+
+Specify the CTest ``Site`` setting
+in a :manual:`ctest(1)` dashboard client script.

+ 5 - 0
Help/variable/CTEST_SOURCE_DIRECTORY.rst

@@ -0,0 +1,5 @@
+CTEST_SOURCE_DIRECTORY
+----------------------
+
+Specify the CTest ``SourceDirectory`` setting
+in a :manual:`ctest(1)` dashboard client script.

+ 5 - 0
Help/variable/CTEST_SVN_COMMAND.rst

@@ -0,0 +1,5 @@
+CTEST_SVN_COMMAND
+-----------------
+
+Specify the CTest ``SVNCommand`` setting
+in a :manual:`ctest(1)` dashboard client script.

+ 5 - 0
Help/variable/CTEST_SVN_OPTIONS.rst

@@ -0,0 +1,5 @@
+CTEST_SVN_OPTIONS
+-----------------
+
+Specify the CTest ``SVNOptions`` setting
+in a :manual:`ctest(1)` dashboard client script.

+ 5 - 0
Help/variable/CTEST_SVN_UPDATE_OPTIONS.rst

@@ -0,0 +1,5 @@
+CTEST_SVN_UPDATE_OPTIONS
+------------------------
+
+Specify the CTest ``SVNUpdateOptions`` setting
+in a :manual:`ctest(1)` dashboard client script.

+ 5 - 0
Help/variable/CTEST_TEST_TIMEOUT.rst

@@ -0,0 +1,5 @@
+CTEST_TEST_TIMEOUT
+------------------
+
+Specify the CTest ``TimeOut`` setting
+in a :manual:`ctest(1)` dashboard client script.

+ 5 - 0
Help/variable/CTEST_TRIGGER_SITE.rst

@@ -0,0 +1,5 @@
+CTEST_TRIGGER_SITE
+------------------
+
+Specify the CTest ``TriggerSite`` setting
+in a :manual:`ctest(1)` dashboard client script.

+ 5 - 0
Help/variable/CTEST_UPDATE_COMMAND.rst

@@ -0,0 +1,5 @@
+CTEST_UPDATE_COMMAND
+--------------------
+
+Specify the CTest ``UpdateCommand`` setting
+in a :manual:`ctest(1)` dashboard client script.

+ 5 - 0
Help/variable/CTEST_UPDATE_OPTIONS.rst

@@ -0,0 +1,5 @@
+CTEST_UPDATE_OPTIONS
+--------------------
+
+Specify the CTest ``UpdateOptions`` setting
+in a :manual:`ctest(1)` dashboard client script.

+ 5 - 0
Help/variable/CTEST_USE_LAUNCHERS.rst

@@ -0,0 +1,5 @@
+CTEST_USE_LAUNCHERS
+-------------------
+
+Specify the CTest ``UseLaunchers`` setting
+in a :manual:`ctest(1)` dashboard client script.