diff options
| author | Stephen Kelly <steveire@gmail.com> | 2014-10-20 20:20:42 (GMT) |
|---|---|---|
| committer | Stephen Kelly <steveire@gmail.com> | 2014-10-20 20:21:57 (GMT) |
| commit | cd4fa896b1d11c26edf07bae19d262c971901827 (patch) | |
| tree | 8d7d686bf11fb141a6cc02e067366a3a0a922234 /Help/manual/cmake-policies.7.rst | |
| parent | 08f29c600877a445ef2f5b4e6125563febeb1e38 (diff) | |
| download | CMake-cd4fa896b1d11c26edf07bae19d262c971901827.zip CMake-cd4fa896b1d11c26edf07bae19d262c971901827.tar.gz CMake-cd4fa896b1d11c26edf07bae19d262c971901827.tar.bz2 | |
Help: Document that policies are not feature toggles.
Diffstat (limited to 'Help/manual/cmake-policies.7.rst')
| -rw-r--r-- | Help/manual/cmake-policies.7.rst | 6 |
1 files changed, 6 insertions, 0 deletions
diff --git a/Help/manual/cmake-policies.7.rst b/Help/manual/cmake-policies.7.rst index f1717a0..8edf708 100644 --- a/Help/manual/cmake-policies.7.rst +++ b/Help/manual/cmake-policies.7.rst @@ -20,6 +20,12 @@ for a policy, also avoiding the warning. Each policy can also be set to either ``NEW`` or ``OLD`` behavior explicitly on the command line with the :variable:`CMAKE_POLICY_DEFAULT_CMP<NNNN>` variable. +Note that policies are not reliable feature toggles. A policy should +almost never be set to ``OLD``, except to silence warnings in an otherwise +frozen or stable codebase, or temporarily as part of a larger migration +path. The ``OLD`` behavior of each policy is undesirable and will be +replaced with an error condition in a future release. + The :command:`cmake_minimum_required` command does more than report an error if a too-old version of CMake is used to build a project. It also sets all policies introduced in that CMake version or earlier to |