diff options
Diffstat (limited to 'share/cmake-3.10/Help/command/ctest_build.rst')
-rw-r--r-- | share/cmake-3.10/Help/command/ctest_build.rst | 80 |
1 files changed, 0 insertions, 80 deletions
diff --git a/share/cmake-3.10/Help/command/ctest_build.rst b/share/cmake-3.10/Help/command/ctest_build.rst deleted file mode 100644 index 55bb4a3..0000000 --- a/share/cmake-3.10/Help/command/ctest_build.rst +++ /dev/null @@ -1,80 +0,0 @@ -ctest_build ------------ - -Perform the :ref:`CTest Build Step` as a :ref:`Dashboard Client`. - -:: - - ctest_build([BUILD <build-dir>] [APPEND] - [CONFIGURATION <config>] - [FLAGS <flags>] - [PROJECT_NAME <project-name>] - [TARGET <target-name>] - [NUMBER_ERRORS <num-err-var>] - [NUMBER_WARNINGS <num-warn-var>] - [RETURN_VALUE <result-var>] - [CAPTURE_CMAKE_ERROR <result-var>] - ) - -Build the project and store results in ``Build.xml`` -for submission with the :command:`ctest_submit` command. - -The :variable:`CTEST_BUILD_COMMAND` variable may be set to explicitly -specify the build command line. Otherwise the build command line is -computed automatically based on the options given. - -The options are: - -``BUILD <build-dir>`` - Specify the top-level build directory. If not given, the - :variable:`CTEST_BINARY_DIRECTORY` variable is used. - -``APPEND`` - Mark ``Build.xml`` for append to results previously submitted to a - dashboard server since the last :command:`ctest_start` call. - Append semantics are defined by the dashboard server in use. - This does *not* cause results to be appended to a ``.xml`` file - produced by a previous call to this command. - -``CONFIGURATION <config>`` - Specify the build configuration (e.g. ``Debug``). If not - specified the ``CTEST_BUILD_CONFIGURATION`` variable will be checked. - Otherwise the ``-C <cfg>`` option given to the :manual:`ctest(1)` - command will be used, if any. - -``FLAGS <flags>`` - Pass additional arguments to the underlying build command. - If not specified the ``CTEST_BUILD_FLAGS`` variable will be checked. - This can, e.g., be used to trigger a parallel build using the - ``-j`` option of make. See the :module:`ProcessorCount` module - for an example. - -``PROJECT_NAME <project-name>`` - Set the name of the project to build. This should correspond - to the top-level call to the :command:`project` command. - If not specified the ``CTEST_PROJECT_NAME`` variable will be checked. - -``TARGET <target-name>`` - Specify the name of a target to build. If not specified the - ``CTEST_BUILD_TARGET`` variable will be checked. Otherwise the - default target will be built. This is the "all" target - (called ``ALL_BUILD`` in :ref:`Visual Studio Generators`). - -``NUMBER_ERRORS <num-err-var>`` - Store the number of build errors detected in the given variable. - -``NUMBER_WARNINGS <num-warn-var>`` - Store the number of build warnings detected in the given variable. - -``RETURN_VALUE <result-var>`` - Store the return value of the native build tool in the given variable. - -``CAPTURE_CMAKE_ERROR <result-var>`` - Store in the ``<result-var>`` variable -1 if there are any errors running - the command and prevent ctest from returning non-zero if an error occurs. - -``QUIET`` - Suppress any CTest-specific non-error output that would have been - printed to the console otherwise. The summary of warnings / errors, - as well as the output from the native build tool is unaffected by - this option. |