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.
29 lines
1.0 KiB
ReStructuredText
29 lines
1.0 KiB
ReStructuredText
CMP0052
|
|
-------
|
|
|
|
.. versionadded:: 3.1
|
|
|
|
Reject source and build dirs in installed
|
|
:prop_tgt:`INTERFACE_INCLUDE_DIRECTORIES`.
|
|
|
|
CMake 3.0 and lower allowed subdirectories of the source directory or build
|
|
directory to be in the :prop_tgt:`INTERFACE_INCLUDE_DIRECTORIES` of
|
|
installed and exported targets, if the directory was also a subdirectory of
|
|
the installation prefix. This makes the installation depend on the
|
|
existence of the source dir or binary dir, and the installation will be
|
|
broken if either are removed after installation.
|
|
|
|
See :ref:`Include Directories and Usage Requirements` for more on
|
|
specifying include directories for targets.
|
|
|
|
The ``OLD`` behavior for this policy is to export the content of the
|
|
:prop_tgt:`INTERFACE_INCLUDE_DIRECTORIES` with the source or binary
|
|
directory. The ``NEW`` behavior for this
|
|
policy is to issue an error if such a directory is used.
|
|
|
|
.. |INTRODUCED_IN_CMAKE_VERSION| replace:: 3.1
|
|
.. |WARNS_OR_DOES_NOT_WARN| replace:: warns
|
|
.. include:: STANDARD_ADVICE.txt
|
|
|
|
.. include:: DEPRECATED.txt
|