diff options
| author | Brad King <brad.king@kitware.com> | 2021-11-23 14:53:23 (GMT) |
|---|---|---|
| committer | Kitware Robot <kwrobot@kitware.com> | 2021-11-23 14:53:43 (GMT) |
| commit | eaef62ec3b63697c45cbea05ff1d89964b439912 (patch) | |
| tree | fe410152f2c1ebf6241c92c0d630fead29424f1e /Help/variable | |
| parent | e18bed1bc1ef95e3ea5971ddb00a774c6c2c5575 (diff) | |
| parent | 69b70968bd1a90eaf41c55b61604874cfebfd345 (diff) | |
| download | CMake-eaef62ec3b63697c45cbea05ff1d89964b439912.zip CMake-eaef62ec3b63697c45cbea05ff1d89964b439912.tar.gz CMake-eaef62ec3b63697c45cbea05ff1d89964b439912.tar.bz2 | |
Merge topic 'doc-policy-default'
69b70968bd Help: Suggest CMAKE_POLICY_DEFAULT_CMP0126 in CMP0126 docs
5b1c24255f Help: Suggest CMAKE_POLICY_DEFAULT_CMP0077 in CMP0077 docs
c44636a89b Help: Document more use cases for CMAKE_POLICY_DEFAULT_CMPNNNN
Acked-by: Kitware Robot <kwrobot@kitware.com>
Merge-request: !6756
Diffstat (limited to 'Help/variable')
| -rw-r--r-- | Help/variable/CMAKE_POLICY_DEFAULT_CMPNNNN.rst | 19 |
1 files changed, 13 insertions, 6 deletions
diff --git a/Help/variable/CMAKE_POLICY_DEFAULT_CMPNNNN.rst b/Help/variable/CMAKE_POLICY_DEFAULT_CMPNNNN.rst index 43582be..d643fb8 100644 --- a/Help/variable/CMAKE_POLICY_DEFAULT_CMPNNNN.rst +++ b/Help/variable/CMAKE_POLICY_DEFAULT_CMPNNNN.rst @@ -9,9 +9,16 @@ the given version unset. Set ``CMAKE_POLICY_DEFAULT_CMP<NNNN>`` to ``OLD`` or ``NEW`` to specify the default for policy ``CMP<NNNN>``, where ``<NNNN>`` is the policy number. -This variable should not be set by a project in CMake code; use -:command:`cmake_policy(SET)` instead. Users running CMake may set this -variable in the cache (e.g. ``-DCMAKE_POLICY_DEFAULT_CMP<NNNN>=<OLD|NEW>``) -to set a policy not otherwise set by the project. Set to ``OLD`` to quiet a -policy warning while using old behavior or to ``NEW`` to try building the -project with new behavior. +This variable should not be set by a project in CMake code as a way to +set its own policies; use :command:`cmake_policy(SET)` instead. This +variable is meant to externally set policies for which a project has +not itself been updated: + +* Users running CMake may set this variable in the cache + (e.g. ``-DCMAKE_POLICY_DEFAULT_CMP<NNNN>=<OLD|NEW>``). Set it to ``OLD`` + to quiet a policy warning while using old behavior or to ``NEW`` to + try building the project with new behavior. + +* Projects may set this variable before a call to :command:`add_subdirectory` + that adds a third-party project in order to set its policies without + modifying third-party code. |