浏览代码

Help: Document cmake_minimum_required deprecation of old versions

Document the deprecation warnings added by commit 5845c218d7 (Deprecate
compatibility with CMake versions older than 2.8.12, 2020-06-12,
v3.19.0-rc1~629^2) and commit 3a4791548d (Deprecate compatibility with
CMake versions older than 3.5, 2023-02-09, v3.27.0-rc1~508^2).

Fixes: #25196
Brad King 2 年之前
父节点
当前提交
741755f637
共有 3 个文件被更改,包括 19 次插入0 次删除
  1. 15 0
      Help/command/DEPRECATED_POLICY_VERSIONS.txt
  2. 2 0
      Help/command/cmake_minimum_required.rst
  3. 2 0
      Help/command/cmake_policy.rst

+ 15 - 0
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.

+ 2 - 0
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
 ^^^^^^^^
 

+ 2 - 0
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
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^