mirror of
https://github.com/Kitware/CMake.git
synced 2026-02-14 02:59:53 -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
1.0 KiB
ReStructuredText
28 lines
1.0 KiB
ReStructuredText
CMP0041
|
|
-------
|
|
|
|
Error on relative include with generator expression.
|
|
|
|
Diagnostics in CMake 2.8.12 and lower silently ignored an entry in the
|
|
:prop_tgt:`INTERFACE_INCLUDE_DIRECTORIES` of a target if it contained a generator
|
|
expression at any position.
|
|
|
|
The path entries in that target property should not be relative. High-level
|
|
API should ensure that by adding either a source directory or a install
|
|
directory prefix, as appropriate.
|
|
|
|
As an additional diagnostic, the :prop_tgt:`INTERFACE_INCLUDE_DIRECTORIES` generated
|
|
on an :prop_tgt:`IMPORTED` target for the install location should not contain
|
|
paths in the source directory or the build directory.
|
|
|
|
The ``OLD`` behavior for this policy is to ignore relative path entries if they
|
|
contain a generator expression. The ``NEW`` behavior for this policy is to report
|
|
an error if a generator expression appears in another location and the path is
|
|
relative.
|
|
|
|
.. |INTRODUCED_IN_CMAKE_VERSION| replace:: 3.0
|
|
.. |WARNS_OR_DOES_NOT_WARN| replace:: warns
|
|
.. include:: STANDARD_ADVICE.txt
|
|
|
|
.. include:: DEPRECATED.txt
|