https://github.com/Kitware/CMake
Raw File
Tip revision: df8057645e75bd1f99a6f82178ef8d2a26ead3cc authored by Brad King on 21 March 2024, 14:07:54 UTC
Merge branch 'release-3.29'
Tip revision: df80576
CMP0024.rst
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
back to top