summaryrefslogtreecommitdiffstats
path: root/Help/policy
diff options
context:
space:
mode:
authorCraig Scott <craig.scott@crascit.com>2024-08-16 00:49:22 (GMT)
committerCraig Scott <craig.scott@crascit.com>2024-08-16 01:10:27 (GMT)
commitdd87640a22203c4181f42403ac3b8e73f7facc35 (patch)
tree202ccaea1ab972a36a4a017b7af822cd939e2d37 /Help/policy
parent2904ce00d2ed6ad5dac6d3459af62d8223e06ce0 (diff)
downloadCMake-dd87640a22203c4181f42403ac3b8e73f7facc35.zip
CMake-dd87640a22203c4181f42403ac3b8e73f7facc35.tar.gz
CMake-dd87640a22203c4181f42403ac3b8e73f7facc35.tar.bz2
CMakeFindFrameworks: Deprecate the module subject to policy CMP0173
Fixes: #20446
Diffstat (limited to 'Help/policy')
-rw-r--r--Help/policy/CMP0173.rst22
1 files changed, 22 insertions, 0 deletions
diff --git a/Help/policy/CMP0173.rst b/Help/policy/CMP0173.rst
new file mode 100644
index 0000000..30de19f
--- /dev/null
+++ b/Help/policy/CMP0173.rst
@@ -0,0 +1,22 @@
+CMP0173
+-------
+
+.. versionadded:: 3.31
+
+The :module:`CMakeFindFrameworks` module is removed.
+
+CMake's framework handling has evolved well beyond what the
+``CMakeFindFrameworks`` module supports. The module lacks any handling of
+XCFrameworks, it never documented the one command it provides, and
+:command:`find_library` provides superior capabilities in all respects.
+
+The ``OLD`` behavior of this policy is for :module:`CMakeFindFrameworks` to
+continue to provide the undocumented ``cmake_find_frameworks()`` command.
+The ``NEW`` behavior halts with a fatal error if anything tries to include
+the module.
+
+.. |INTRODUCED_IN_CMAKE_VERSION| replace:: 3.31
+.. |WARNS_OR_DOES_NOT_WARN| replace:: warns
+.. include:: STANDARD_ADVICE.txt
+
+.. include:: DEPRECATED.txt