cmake/Help/policy/CMP0024.rst

25 lines
1016 B
ReStructuredText
Raw Normal View History

2014-08-03 19:52:23 +02:00
CMP0024
-------
Disallow include export result.
2019-11-11 23:01:05 +01:00
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
2014-08-03 19:52:23 +02:00
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
2019-11-11 23:01:05 +01:00
the :command:`export` command to be executed at generate-time. Use ``ALIAS``
2014-08-03 19:52:23 +02:00
targets instead in cases where the goal is to refer to targets by
another name.
2019-11-11 23:01:05 +01:00
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.
2014-08-03 19:52:23 +02:00
2024-04-14 22:45:38 +02:00
.. |INTRODUCED_IN_CMAKE_VERSION| replace:: 3.0
.. |WARNS_OR_DOES_NOT_WARN| replace:: warns
.. include:: STANDARD_ADVICE.txt
2015-08-17 11:37:30 +02:00
.. include:: DEPRECATED.txt