mirror of
https://github.com/Kitware/CMake.git
synced 2026-01-06 05:40:54 -06:00
ad3c2c0b03
Every policy's documentation has a paragraph on what version of CMake introduced it, how to set the policy, and whether CMake warns if the policy is not set. The wording of this paragraph has diverged across policies over time. Factor the paragraph out into a standard advice document included by every policy.
28 lines
969 B
ReStructuredText
28 lines
969 B
ReStructuredText
CMP0075
|
|
-------
|
|
|
|
.. versionadded:: 3.12
|
|
|
|
Include file check macros honor ``CMAKE_REQUIRED_LIBRARIES``.
|
|
|
|
In CMake 3.12 and above, the
|
|
|
|
* ``check_include_file`` macro in the :module:`CheckIncludeFile` module, the
|
|
* ``check_include_file_cxx`` macro in the
|
|
:module:`CheckIncludeFileCXX` module, and the
|
|
* ``check_include_files`` macro in the :module:`CheckIncludeFiles` module
|
|
|
|
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.
|
|
|
|
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.
|
|
|
|
.. |INTRODUCED_IN_CMAKE_VERSION| replace:: 3.12
|
|
.. |WARNS_OR_DOES_NOT_WARN| replace:: warns
|
|
.. include:: STANDARD_ADVICE.txt
|
|
|
|
.. include:: DEPRECATED.txt
|