diff options
| author | Brad King <brad.king@kitware.com> | 2021-11-22 14:57:04 -0500 |
|---|---|---|
| committer | Brad King <brad.king@kitware.com> | 2021-11-22 14:57:22 -0500 |
| commit | 69b70968bd1a90eaf41c55b61604874cfebfd345 (patch) | |
| tree | 5b75591a27c57c412e353b012363aab31ada8179 /Help/policy | |
| parent | 5b1c24255f3ca2404134d2fd9270d2edc0801bdd (diff) | |
| download | cmake-69b70968bd1a90eaf41c55b61604874cfebfd345.tar.gz | |
Help: Suggest CMAKE_POLICY_DEFAULT_CMP0126 in CMP0126 docs
Diffstat (limited to 'Help/policy')
| -rw-r--r-- | Help/policy/CMP0126.rst | 5 |
1 files changed, 4 insertions, 1 deletions
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>>` |