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/CMP0116.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/CMP0116.rst')
-rw-r--r-- | Help/policy/CMP0116.rst | 12 |
1 files changed, 8 insertions, 4 deletions
diff --git a/Help/policy/CMP0116.rst b/Help/policy/CMP0116.rst index 18e5a96..b0fc896 100644 --- a/Help/policy/CMP0116.rst +++ b/Help/policy/CMP0116.rst @@ -33,9 +33,13 @@ time of the custom command's creation, and you can have custom commands in the same directory with different values for ``CMP0116`` by setting the policy before each custom command. -This policy was introduced in CMake version 3.20. Unlike most policies, -CMake version |release| does *not* warn by default when this policy is not set -(unless ``DEPFILE`` is used in a subdirectory) and simply uses ``OLD`` -behavior. See documentation of the +.. |INTRODUCED_IN_CMAKE_VERSION| replace:: 3.20 +.. |WARNS_OR_DOES_NOT_WARN| replace:: + does *not* warn by default (unless ``DEPFILE`` is used in a subdirectory) +.. include:: STANDARD_ADVICE.txt + +See documentation of the :variable:`CMAKE_POLICY_WARNING_CMP0116 <CMAKE_POLICY_WARNING_CMP<NNNN>>` variable to control the warning. + +.. include:: DEPRECATED.txt |