diff options
author | Brad King <brad.king@kitware.com> | 2024-01-11 18:43:55 (GMT) |
---|---|---|
committer | Brad King <brad.king@kitware.com> | 2024-01-11 19:48:01 (GMT) |
commit | ad3c2c0b03457c4410e31bbc8daae3bf21be2653 (patch) | |
tree | 8078b7518d3bff7a5ddfe6dc9b05df33b94915be /Help/policy/CMP0025.rst | |
parent | c6d69d84dbdf3e2db70e6272a95d977c2c685ee2 (diff) | |
download | CMake-ad3c2c0b03457c4410e31bbc8daae3bf21be2653.zip CMake-ad3c2c0b03457c4410e31bbc8daae3bf21be2653.tar.gz CMake-ad3c2c0b03457c4410e31bbc8daae3bf21be2653.tar.bz2 |
Help: Normalize and consolidate standard policy advice paragraph
Every policy's documentation has a paragraph on what version of CMake
introduced it, how to set the policy, and whether CMake warns if the
policy is not set. The wording of this paragraph has diverged across
policies over time. Factor the paragraph out into a standard advice
document included by every policy.
Diffstat (limited to 'Help/policy/CMP0025.rst')
-rw-r--r-- | Help/policy/CMP0025.rst | 8 |
1 files changed, 4 insertions, 4 deletions
diff --git a/Help/policy/CMP0025.rst b/Help/policy/CMP0025.rst index ba5e1e9..cfbed2a 100644 --- a/Help/policy/CMP0025.rst +++ b/Help/policy/CMP0025.rst @@ -18,10 +18,10 @@ to the invocation of either command. The ``OLD`` behavior for this policy is to use compiler id ``Clang``. The ``NEW`` behavior for this policy is to use compiler id ``AppleClang``. -This policy was introduced in CMake version 3.0. Use the -:command:`cmake_policy` command to set this policy to ``OLD`` or ``NEW`` -explicitly. Unlike most policies, CMake version |release| does *not* warn -by default when this policy is not set and simply uses ``OLD`` behavior. +.. |INTRODUCED_IN_CMAKE_VERSION| replace:: 3.0 +.. |WARNS_OR_DOES_NOT_WARN| replace:: does *not* warn by default +.. include:: STANDARD_ADVICE.txt + See documentation of the :variable:`CMAKE_POLICY_WARNING_CMP0025 <CMAKE_POLICY_WARNING_CMP<NNNN>>` variable to control the warning. |