summaryrefslogtreecommitdiff
path: root/share/cmake-3.17/Help/policy/CMP0024.rst
blob: 6e24b04542375dc6eaaaec9028a3bc7b204ec950 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
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.

This policy was introduced in CMake version 3.0.  CMake version
|release| warns when the policy is not set and uses ``OLD`` behavior.  Use
the :command:`cmake_policy` command to set it to ``OLD`` or ``NEW``
explicitly.

.. include:: DEPRECATED.txt