New in version 3.12.
Include file check macros honor
In CMake 3.12 and above, the
check_include_file macro in the
CheckIncludeFile module, the
check_include_file_cxx macro in the
CheckIncludeFileCXX module, and the
check_include_files macro in the
now 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.
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 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.