mirror of
https://github.com/Kitware/CMake.git
synced 2026-01-05 13:20:47 -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.
22 lines
787 B
ReStructuredText
22 lines
787 B
ReStructuredText
CMP0021
|
|
-------
|
|
|
|
Fatal error on relative paths in :prop_tgt:`INCLUDE_DIRECTORIES` target
|
|
property.
|
|
|
|
CMake 2.8.10.2 and lower allowed the :prop_tgt:`INCLUDE_DIRECTORIES` target
|
|
property to contain relative paths. The base path for such relative
|
|
entries is not well defined. CMake 2.8.12 issues a ``FATAL_ERROR`` if the
|
|
:prop_tgt:`INCLUDE_DIRECTORIES` property contains a relative path.
|
|
|
|
The ``OLD`` behavior for this policy is not to warn about relative paths
|
|
in the ``INCLUDE_DIRECTORIES`` target property. The ``NEW`` behavior for this
|
|
policy is to issue a ``FATAL_ERROR`` if ``INCLUDE_DIRECTORIES`` contains a
|
|
relative path.
|
|
|
|
.. |INTRODUCED_IN_CMAKE_VERSION| replace:: 2.8.12
|
|
.. |WARNS_OR_DOES_NOT_WARN| replace:: warns
|
|
.. include:: STANDARD_ADVICE.txt
|
|
|
|
.. include:: DEPRECATED.txt
|