diff options
author | Craig Scott <craig.scott@crascit.com> | 2024-08-16 00:49:22 (GMT) |
---|---|---|
committer | Craig Scott <craig.scott@crascit.com> | 2024-08-16 01:10:27 (GMT) |
commit | dd87640a22203c4181f42403ac3b8e73f7facc35 (patch) | |
tree | 202ccaea1ab972a36a4a017b7af822cd939e2d37 /Help/policy | |
parent | 2904ce00d2ed6ad5dac6d3459af62d8223e06ce0 (diff) | |
download | CMake-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.rst | 22 |
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 |