mirror of
https://github.com/Kitware/CMake.git
synced 2026-05-03 12:49:50 -05:00
Help: Disambiguate cmake(1) program modes in Sphinx option references
Define the entry point to each mode as an option for the `cmake` program, but reference the options for that mode as part of stand-in `cmake-<mode>` programs.
This commit is contained in:
@@ -7,7 +7,7 @@ This is the full path to the top level of the current CMake build
|
||||
tree. For an in-source build, this would be the same as
|
||||
:variable:`CMAKE_SOURCE_DIR`.
|
||||
|
||||
When run in :option:`-P <cmake_P -P>` script mode, CMake sets the variables
|
||||
When run in :option:`cmake -P` script mode, CMake sets the variables
|
||||
:variable:`CMAKE_BINARY_DIR`, :variable:`CMAKE_SOURCE_DIR`,
|
||||
:variable:`CMAKE_CURRENT_BINARY_DIR` and
|
||||
:variable:`CMAKE_CURRENT_SOURCE_DIR` to the current working directory.
|
||||
|
||||
@@ -9,7 +9,7 @@ create a binary directory in the build tree, and as it is being
|
||||
processed this variable will be set. For in-source builds this is the
|
||||
current source directory being processed.
|
||||
|
||||
When run in :option:`-P <cmake_P -P>` script mode, CMake sets the variables
|
||||
When run in :option:`cmake -P` script mode, CMake sets the variables
|
||||
:variable:`CMAKE_BINARY_DIR`, :variable:`CMAKE_SOURCE_DIR`,
|
||||
:variable:`CMAKE_CURRENT_BINARY_DIR` and
|
||||
:variable:`CMAKE_CURRENT_SOURCE_DIR` to the current working directory.
|
||||
|
||||
@@ -6,7 +6,7 @@ The path to the source directory currently being processed.
|
||||
This is the full path to the source directory that is currently being
|
||||
processed by cmake.
|
||||
|
||||
When run in :option:`-P <cmake_P -P>` script mode, CMake sets the variables
|
||||
When run in :option:`cmake -P` script mode, CMake sets the variables
|
||||
:variable:`CMAKE_BINARY_DIR`, :variable:`CMAKE_SOURCE_DIR`,
|
||||
:variable:`CMAKE_CURRENT_BINARY_DIR` and
|
||||
:variable:`CMAKE_CURRENT_SOURCE_DIR` to the current working directory.
|
||||
|
||||
@@ -27,8 +27,8 @@ first :command:`project` invocation.
|
||||
|
||||
The ``CMAKE_INSTALL_PREFIX`` may be defined when configuring a build tree
|
||||
to set its installation prefix. Or, when using the :manual:`cmake(1)`
|
||||
command-line tool's :option:`--install <cmake --install>` mode, one may
|
||||
specify a different prefix using the :option:`--prefix <cmake --prefix>`
|
||||
command-line tool's :option:`--install <cmake --install>` mode, one may specify
|
||||
a different prefix using the :option:`--prefix <cmake--install --prefix>`
|
||||
option:
|
||||
|
||||
.. code-block:: shell
|
||||
|
||||
@@ -1,9 +1,9 @@
|
||||
CMAKE_SCRIPT_MODE_FILE
|
||||
----------------------
|
||||
|
||||
Full path to the :option:`cmake -P <cmake_P -P>` script file currently being
|
||||
Full path to the :option:`cmake -P` script file currently being
|
||||
processed.
|
||||
|
||||
When run in :option:`cmake -P <cmake_P -P>` script mode, CMake sets this variable to
|
||||
When run in :option:`cmake -P` script mode, CMake sets this variable to
|
||||
the full path of the script file. When run to configure a ``CMakeLists.txt``
|
||||
file, this variable is not set.
|
||||
|
||||
@@ -7,7 +7,7 @@ This is the full path to the top level of the current CMake source
|
||||
tree. For an in-source build, this would be the same as
|
||||
:variable:`CMAKE_BINARY_DIR`.
|
||||
|
||||
When run in :option:`-P <cmake_P -P>` script mode, CMake sets the variables
|
||||
When run in :option:`cmake -P` script mode, CMake sets the variables
|
||||
:variable:`CMAKE_BINARY_DIR`, :variable:`CMAKE_SOURCE_DIR`,
|
||||
:variable:`CMAKE_CURRENT_BINARY_DIR` and
|
||||
:variable:`CMAKE_CURRENT_SOURCE_DIR` to the current working directory.
|
||||
|
||||
Reference in New Issue
Block a user