mirror of
https://github.com/Kitware/CMake.git
synced 2026-02-14 11:09:56 -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.
25 lines
1016 B
ReStructuredText
25 lines
1016 B
ReStructuredText
CMP0024
|
|
-------
|
|
|
|
Disallow include export result.
|
|
|
|
CMake 2.8.12 and lower allowed use of the :command:`include` command with the
|
|
result of the :command:`export` command. This relies on the assumption that
|
|
the :command:`export` command has an immediate effect at configure-time during
|
|
a cmake run. Certain properties of targets are not fully determined
|
|
until later at generate-time, such as the link language and complete
|
|
list of link libraries. Future refactoring will change the effect of
|
|
the :command:`export` command to be executed at generate-time. Use ``ALIAS``
|
|
targets instead in cases where the goal is to refer to targets by
|
|
another name.
|
|
|
|
The ``OLD`` behavior for this policy is to allow including the result of
|
|
an :command:`export` command. The ``NEW`` behavior for this policy is not to
|
|
allow including the result of an :command:`export` command.
|
|
|
|
.. |INTRODUCED_IN_CMAKE_VERSION| replace:: 3.0
|
|
.. |WARNS_OR_DOES_NOT_WARN| replace:: warns
|
|
.. include:: STANDARD_ADVICE.txt
|
|
|
|
.. include:: DEPRECATED.txt
|