mirror of
https://github.com/Kitware/CMake.git
synced 2025-10-14 02:08:27 +08:00
5dd356cefc
Since commit c2dc7e0f53 (Help: Convert genex documentation to sphinx
domain objects, 2021-01-15) we can use `:genex:` cross-references to
link to named generator expressions. Update some places to do this.
This is meant to demonstrate the capability, not as a comprehensive
sweep.
30 lines
1.3 KiB
ReStructuredText
30 lines
1.3 KiB
ReStructuredText
CMP0026
|
|
-------
|
|
|
|
Disallow use of the LOCATION property for build targets.
|
|
|
|
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 :genex:`$<TARGET_FILE>` generator
|
|
expression can be used to determine the eventual :prop_tgt:`LOCATION` of a target
|
|
output.
|
|
|
|
Code which reads the :prop_tgt:`LOCATION` target property can be ported to
|
|
use the :genex:`$<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 :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 :command:`cmake_policy` command to set it to ``OLD`` or ``NEW`` explicitly.
|
|
|
|
.. include:: DEPRECATED.txt
|