mirror of
https://github.com/Kitware/CMake.git
synced 2026-04-27 09:29:15 -05:00
Merge topic 'doc-CMAKE_INSTALL_MODE' into release-3.22
3caeee0c86Help: Clarify CMAKE_INSTALL_MODE documentation699d4a98e2Help: Use definition list for allowed values of CMAKE_INSTALL_MODE Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !6743
This commit is contained in:
@@ -637,6 +637,22 @@ External Project Definition
|
||||
supported). Passing an empty string as the ``<cmd>`` makes the install
|
||||
step do nothing.
|
||||
|
||||
.. note::
|
||||
If the :envvar:`CMAKE_INSTALL_MODE` environment variable is set when the
|
||||
main project is built, it will only have an effect if the following
|
||||
conditions are met:
|
||||
|
||||
* The main project's configure step assumed the external project uses
|
||||
CMake as its build system.
|
||||
* The external project's install command actually runs. Note that due
|
||||
to the way ``ExternalProject`` may use timestamps internally, if
|
||||
nothing the install step depends on needs to be re-executed, the
|
||||
install command might also not need to run.
|
||||
|
||||
Note also that ``ExternalProject`` does not check whether the
|
||||
:envvar:`CMAKE_INSTALL_MODE` environment variable changes from one run
|
||||
to another.
|
||||
|
||||
**Test Step Options:**
|
||||
The test step is only defined if at least one of the following ``TEST_...``
|
||||
options are provided.
|
||||
|
||||
Reference in New Issue
Block a user