mirror of
https://github.com/Kitware/CMake.git
synced 2026-03-12 20:39:49 -05: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.
32 lines
1.3 KiB
ReStructuredText
32 lines
1.3 KiB
ReStructuredText
CMP0066
|
|
-------
|
|
|
|
.. versionadded:: 3.7
|
|
|
|
Honor per-config flags in :command:`try_compile` source-file signature.
|
|
|
|
The source file signature of the :command:`try_compile` command uses the value
|
|
of the :variable:`CMAKE_<LANG>_FLAGS` variable in the test project so that the
|
|
test compilation works as it would in the main project. However, CMake 3.6 and
|
|
below do not also honor config-specific compiler flags such as those in the
|
|
:variable:`CMAKE_<LANG>_FLAGS_DEBUG` variable. CMake 3.7 and above prefer to
|
|
honor config-specific compiler flags too. This policy provides compatibility
|
|
for projects that do not expect config-specific compiler flags to be used.
|
|
|
|
The ``OLD`` behavior of this policy is to ignore config-specific flag
|
|
variables like :variable:`CMAKE_<LANG>_FLAGS_DEBUG` and only use CMake's
|
|
built-in defaults for the current compiler and platform.
|
|
|
|
The ``NEW`` behavior of this policy is to honor config-specific flag
|
|
variabldes like :variable:`CMAKE_<LANG>_FLAGS_DEBUG`.
|
|
|
|
.. |INTRODUCED_IN_CMAKE_VERSION| replace:: 3.7
|
|
.. |WARNS_OR_DOES_NOT_WARN| replace:: does *not* warn by default
|
|
.. include:: STANDARD_ADVICE.txt
|
|
|
|
See documentation of the
|
|
:variable:`CMAKE_POLICY_WARNING_CMP0066 <CMAKE_POLICY_WARNING_CMP<NNNN>>`
|
|
variable to control the warning.
|
|
|
|
.. include:: DEPRECATED.txt
|