summaryrefslogtreecommitdiff
path: root/share/cmake-3.22/Help/policy/CMP0126.rst
diff options
context:
space:
mode:
authorRyan Prichard <rprichard@google.com>2022-01-13 17:30:17 -0800
committerRyan Prichard <rprichard@google.com>2022-01-13 17:30:31 -0800
commit7aea7e9880110799088cd1de509886871078306f (patch)
tree5cf68b7dabd868f99ec4160cf1f7237ff63e4c37 /share/cmake-3.22/Help/policy/CMP0126.rst
parentd09ee7574f3e46668b23b3b6efebd0ea75de85b2 (diff)
downloaddarwin-x86-7aea7e9880110799088cd1de509886871078306f.tar.gz
Fusion2: http://fusion2/610fb8e3-5633-41a6-b50b-ed5819f55cd6 GCS path: gs://ndk-kokoro-release-artifacts/prod/ndk/cmake/darwin_release/3/20211215-131219 Prebuilt updated using: ndk/scripts/update_kokoro_prebuilts.py Test: Treehugger, Kokoro presubmit Bug: http://b/213946898 Change-Id: Icbb6d90cad49dbe67f168075508872b1704d9f61
Diffstat (limited to 'share/cmake-3.22/Help/policy/CMP0126.rst')
-rw-r--r--share/cmake-3.22/Help/policy/CMP0126.rst34
1 files changed, 34 insertions, 0 deletions
diff --git a/share/cmake-3.22/Help/policy/CMP0126.rst b/share/cmake-3.22/Help/policy/CMP0126.rst
new file mode 100644
index 0000000..1b69957
--- /dev/null
+++ b/share/cmake-3.22/Help/policy/CMP0126.rst
@@ -0,0 +1,34 @@
+CMP0126
+-------
+
+.. versionadded:: 3.21
+
+When this policy is set to ``NEW``, the :command:`set(CACHE)` command does not
+remove any normal variable of the same name from the current scope.
+The ``OLD`` behavior removes any normal variable of the same name from the
+current scope in the following situations:
+
+* No cache variable of that name existed previously.
+
+* A cache variable of that name existed previously, but it had no type.
+ This can occur when the variable was set on the command line using a form
+ like ``cmake -DMYVAR=blah`` instead of ``cmake -DMYVAR:STRING=blah``.
+
+Note that the ``NEW`` behavior has an important difference to the similar
+``NEW`` behavior of policy :policy:`CMP0077`. The :command:`set(CACHE)`
+command always sets the cache variable if it did not exist previously,
+regardless of the ``CMP0126`` policy setting. The :command:`option` command
+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
+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>>`
+variable to control the warning.
+
+.. include:: DEPRECATED.txt