diff options
author | Bartosz Kosiorek <bartosz.kosiorek@tomtom.com> | 2019-03-26 15:13:41 (GMT) |
---|---|---|
committer | Bartosz Kosiorek <bartosz.kosiorek@tomtom.com> | 2019-03-27 15:01:20 (GMT) |
commit | 07f3082d3b52f1bcba8dd4ef82b3e02c362b392e (patch) | |
tree | 36eb4256e37351a30273b3852c2d799c0e2e2e03 /Help/policy/CMP0024.rst | |
parent | db20cb2f9f2ff1d00593e0fc921184d99f58749a (diff) | |
download | CMake-07f3082d3b52f1bcba8dd4ef82b3e02c362b392e.zip CMake-07f3082d3b52f1bcba8dd4ef82b3e02c362b392e.tar.gz CMake-07f3082d3b52f1bcba8dd4ef82b3e02c362b392e.tar.bz2 |
Help: Improve documentation links and formatting
Diffstat (limited to 'Help/policy/CMP0024.rst')
-rw-r--r-- | Help/policy/CMP0024.rst | 19 |
1 files changed, 10 insertions, 9 deletions
diff --git a/Help/policy/CMP0024.rst b/Help/policy/CMP0024.rst index 272a56c..6e24b04 100644 --- a/Help/policy/CMP0024.rst +++ b/Help/policy/CMP0024.rst @@ -3,22 +3,23 @@ CMP0024 Disallow include export result. -CMake 2.8.12 and lower allowed use of the include() command with the -result of the export() command. This relies on the assumption that -the export() command has an immediate effect at configure-time during +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 export() command to be executed at generate-time. Use ALIAS +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 export() command. The NEW behavior for this policy is not to -allow including the result of an export() command. +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 cmake_policy command to set it to OLD or NEW explicitly. +|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 |