kolan
/
CMake
1
0
Fork 0
Code Issues Pull Requests Releases Wiki Activity

Merge topic 'update-ctest_build-docs' 

5731fb2e ctest_build: mention CTEST_BUILD_COMMAND in the docs
753da8c6 ctest_build: update the default target documentation
5ab896ae ctest_build: spruce up the documentation a bit
This commit is contained in:
Brad King 2015-05-07 14:32:11 -04:00 committed by CMake Topic Stage
parent e4e09dee92 5731fb2e5e
commit ee1ddec4c1
1 changed files with 16 additions and 14 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

30
Help/command/ctest_build.rst
View File

@ -8,27 +8,29 @@ Build the project.
ctest_build([BUILD build_dir] [TARGET target] [RETURN_VALUE res] ctest_build([BUILD build_dir] [TARGET target] [RETURN_VALUE res]
[APPEND][NUMBER_ERRORS val] [NUMBER_WARNINGS val]) [APPEND][NUMBER_ERRORS val] [NUMBER_WARNINGS val])
Builds the given build directory and stores results in Build.xml. If Builds the given build directory and stores results in Build.xml. If no
no BUILD is given, the CTEST_BINARY_DIRECTORY variable is used. ``BUILD`` is given, the :variable:`CTEST_BINARY_DIRECTORY` variable is used.
The TARGET variable can be used to specify a build target. If none is The ``TARGET`` variable can be used to specify a build target. If none is
specified, the "all" target will be built. specified, the default target ("ALL_BUILD" for Visual Studio generators and
"all" in others) will be built.
The RETURN_VALUE option specifies a variable in which to store the The ``RETURN_VALUE`` option specifies a variable in which to store the
return value of the native build tool. The NUMBER_ERRORS and return value of the native build tool. The ``NUMBER_ERRORS`` and
NUMBER_WARNINGS options specify variables in which to store the number ``NUMBER_WARNINGS`` options specify variables in which to store the number
of build errors and warnings detected. of build errors and warnings detected.
The APPEND option marks results for append to those previously The ``APPEND`` option marks results for append to those previously
submitted to a dashboard server since the last ctest_start. Append submitted to a dashboard server since the last :command:`ctest_start`. Append
semantics are defined by the dashboard server in use. semantics are defined by the dashboard server in use.
The QUIET option suppresses any CTest-specific non-error output The ``QUIET`` option suppresses any CTest-specific non-error output
that would have been printed to the console otherwise. The summary that would have been printed to the console otherwise. The summary
of warnings / errors, as well as the output from the native build tool of warnings / errors, as well as the output from the native build tool
is unaffected by this option. is unaffected by this option.
If set, the contents of the variable CTEST_BUILD_FLAGS are passed as If set, the contents of the variable ``CTEST_BUILD_COMMAND`` is used to build
additional arguments to the underlying build command. This can e.g. be the project. In addition, if set, the contents of the variable
used to trigger a parallel build using the -j option of make. See ``CTEST_BUILD_FLAGS`` are passed as additional arguments to the underlying
:module:`ProcessorCount` for an example. build command. This can, e.g., be used to trigger a parallel build using the
``-j`` option of make. See :module:`ProcessorCount` for an example.