New in version 3.12.
Include file check macros honor CMAKE_REQUIRED_LIBRARIES
.
In CMake 3.12 and above, the
check_include_file
macro in the CheckIncludeFile
module, thecheck_include_file_cxx
macro in the CheckIncludeFileCXX
module, and thecheck_include_files
macro in the CheckIncludeFiles
modulenow prefer to link the check executable to the libraries listed in the CMAKE_REQUIRED_LIBRARIES
variable. This policy provides compatibility with projects that have not been updated to expect this behavior.
The OLD
behavior for this policy is to ignore CMAKE_REQUIRED_LIBRARIES
in the include file check macros. The NEW
behavior of this policy is to honor CMAKE_REQUIRED_LIBRARIES
in the include file check macros.
This policy was introduced in CMake version 3.12. CMake version 3.19.0-rc3 warns when the policy is not set and uses OLD
behavior. Use the cmake_policy()
command to set it to OLD
or NEW
explicitly.
Note
The OLD
behavior of a policy is deprecated by definition
and may be removed in a future version of CMake.
© 2000–2020 Kitware, Inc. and Contributors
Licensed under the BSD 3-clause License.
https://cmake.org/cmake/help/v3.19/policy/CMP0075.html