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/CMP0026.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/CMP0026.rst')
-rw-r--r-- | Help/policy/CMP0026.rst | 23 |
1 files changed, 12 insertions, 11 deletions
diff --git a/Help/policy/CMP0026.rst b/Help/policy/CMP0026.rst index 3fe1374..3401d4a 100644 --- a/Help/policy/CMP0026.rst +++ b/Help/policy/CMP0026.rst @@ -3,26 +3,27 @@ CMP0026 Disallow use of the LOCATION property for build targets. -CMake 2.8.12 and lower allowed reading the LOCATION target +CMake 2.8.12 and lower allowed reading the :prop_tgt:`LOCATION` target property (and configuration-specific variants) to determine the eventual location of build targets. This relies on the assumption that all necessary information is available at configure-time to determine the final location and filename of the target. However, this property is not fully determined until later at -generate-time. At generate time, the $<TARGET_FILE> generator -expression can be used to determine the eventual LOCATION of a target +generate-time. At generate time, the ``$<TARGET_FILE>`` generator +expression can be used to determine the eventual :prop_tgt:`LOCATION` of a target output. -Code which reads the LOCATION target property can be ported to use the -$<TARGET_FILE> generator expression together with the file(GENERATE) -subcommand to generate a file containing the target location. +Code which reads the :prop_tgt:`LOCATION` target property can be ported to +use the ``$<TARGET_FILE>`` generator expression together with the +:command:`file(GENERATE)` subcommand to generate a file containing +the target location. -The OLD behavior for this policy is to allow reading the LOCATION -properties from build-targets. The NEW behavior for this policy is to -not to allow reading the LOCATION properties from build-targets. +The ``OLD`` behavior for this policy is to allow reading the :prop_tgt:`LOCATION` +properties from build-targets. The ``NEW`` behavior for this policy is to +not to allow reading the :prop_tgt:`LOCATION` properties from build-targets. 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 |