summaryrefslogtreecommitdiffstats
path: root/Help
diff options
context:
space:
mode:
authorBrad King <brad.king@kitware.com>2021-11-22 19:57:04 (GMT)
committerBrad King <brad.king@kitware.com>2021-11-22 19:57:22 (GMT)
commit69b70968bd1a90eaf41c55b61604874cfebfd345 (patch)
tree5b75591a27c57c412e353b012363aab31ada8179 /Help
parent5b1c24255f3ca2404134d2fd9270d2edc0801bdd (diff)
downloadCMake-69b70968bd1a90eaf41c55b61604874cfebfd345.zip
CMake-69b70968bd1a90eaf41c55b61604874cfebfd345.tar.gz
CMake-69b70968bd1a90eaf41c55b61604874cfebfd345.tar.bz2
Help: Suggest CMAKE_POLICY_DEFAULT_CMP0126 in CMP0126 docs
Diffstat (limited to 'Help')
-rw-r--r--Help/policy/CMP0126.rst5
1 files changed, 4 insertions, 1 deletions
diff --git a/Help/policy/CMP0126.rst b/Help/policy/CMP0126.rst
index ba027b3..1b69957 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>>`