diff --git a/Help/command/DEPRECATED_POLICY_VERSIONS.txt b/Help/command/DEPRECATED_POLICY_VERSIONS.txt new file mode 100644 index 0000000000000000000000000000000000000000..7c68260042cd4318f015862f900158a7b6dd4a14 --- /dev/null +++ b/Help/command/DEPRECATED_POLICY_VERSIONS.txt @@ -0,0 +1,15 @@ +.. versionchanged:: 3.27 + + Compatibility with versions of CMake older than 3.5 is deprecated. + Calls to :command:`cmake_minimum_required(VERSION)` or + :command:`cmake_policy(VERSION)` that do not specify at least + 3.5 as their policy version (optionally via ``...<max>``) + will produce a deprecation warning in CMake 3.27 and above. + +.. versionchanged:: 3.19 + + Compatibility with versions of CMake older than 2.8.12 is deprecated. + Calls to :command:`cmake_minimum_required(VERSION)` or + :command:`cmake_policy(VERSION)` that do not specify at least + 2.8.12 as their policy version (optionally via ``...<max>``) + will produce a deprecation warning in CMake 3.19 and above. diff --git a/Help/command/cmake_minimum_required.rst b/Help/command/cmake_minimum_required.rst index 031bd5690e16f978ad5503fc053625b48fab9fed..de2c8f3178b05abf41aa81d34520d41624892a13 100644 --- a/Help/command/cmake_minimum_required.rst +++ b/Help/command/cmake_minimum_required.rst @@ -80,6 +80,8 @@ invokes which enables compatibility features for CMake 2.4 and lower. +.. include:: DEPRECATED_POLICY_VERSIONS.txt + See Also ^^^^^^^^ diff --git a/Help/command/cmake_policy.rst b/Help/command/cmake_policy.rst index cde74a733cdf85e9be418341ad05f994ff27dda0..d7880bc213a9dd543ace7c5953fb10694ef3b498 100644 --- a/Help/command/cmake_policy.rst +++ b/Help/command/cmake_policy.rst @@ -52,6 +52,8 @@ version and tells newer CMake versions to warn about their new policies. Note that the :command:`cmake_minimum_required(VERSION)` command implicitly calls ``cmake_policy(VERSION)`` too. +.. include:: DEPRECATED_POLICY_VERSIONS.txt + Setting Policies Explicitly ^^^^^^^^^^^^^^^^^^^^^^^^^^^