diff options
| author | Brad King <brad.king@kitware.com> | 2021-11-23 14:53:23 +0000 |
|---|---|---|
| committer | Kitware Robot <kwrobot@kitware.com> | 2021-11-23 09:53:43 -0500 |
| commit | eaef62ec3b63697c45cbea05ff1d89964b439912 (patch) | |
| tree | fe410152f2c1ebf6241c92c0d630fead29424f1e /Help/policy | |
| parent | e18bed1bc1ef95e3ea5971ddb00a774c6c2c5575 (diff) | |
| parent | 69b70968bd1a90eaf41c55b61604874cfebfd345 (diff) | |
| download | cmake-eaef62ec3b63697c45cbea05ff1d89964b439912.tar.gz | |
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/policy')
| -rw-r--r-- | Help/policy/CMP0077.rst | 4 | ||||
| -rw-r--r-- | Help/policy/CMP0126.rst | 5 |
2 files changed, 7 insertions, 2 deletions
diff --git a/Help/policy/CMP0077.rst b/Help/policy/CMP0077.rst index d8744a9458..482125a794 100644 --- a/Help/policy/CMP0077.rst +++ b/Help/policy/CMP0077.rst @@ -53,6 +53,8 @@ between the two policies. This policy was introduced in CMake version 3.13. CMake version |release| warns when the policy is not set and uses ``OLD`` behavior. Use the :command:`cmake_policy` command to set it to ``OLD`` or ``NEW`` -explicitly. +explicitly within a project. Use the :variable:`CMAKE_POLICY_DEFAULT_CMP0077 +<CMAKE_POLICY_DEFAULT_CMP\<NNNN\>>` variable to set the policy for +a third-party project in a subdirectory without modifying it. .. include:: DEPRECATED.txt diff --git a/Help/policy/CMP0126.rst b/Help/policy/CMP0126.rst index ba027b3514..1b6995762d 100644 --- a/Help/policy/CMP0126.rst +++ b/Help/policy/CMP0126.rst @@ -22,7 +22,10 @@ will *not* set the cache variable if a non-cache variable of the same name already exists and :policy:`CMP0077` is set to ``NEW``. Policy ``CMP0126`` was introduced in CMake version 3.21. Use the -:command:`cmake_policy` command to set it to ``OLD`` or ``NEW`` explicitly. +:command:`cmake_policy` command to set it to ``OLD`` or ``NEW`` explicitly +within a project. Use the :variable:`CMAKE_POLICY_DEFAULT_CMP0126 +<CMAKE_POLICY_DEFAULT_CMP\<NNNN\>>` variable to set the policy for +a third-party project in a subdirectory without modifying it. Unlike many policies, CMake version |release| does *not* warn when the policy is not set and simply uses ``OLD`` behavior. See documentation of the :variable:`CMAKE_POLICY_WARNING_CMP0126 <CMAKE_POLICY_WARNING_CMP<NNNN>>` |