mirror of
https://github.com/Kitware/CMake.git
synced 2026-01-06 05:40:54 -06:00
ad3c2c0b03
Every policy's documentation has a paragraph on what version of CMake introduced it, how to set the policy, and whether CMake warns if the policy is not set. The wording of this paragraph has diverged across policies over time. Factor the paragraph out into a standard advice document included by every policy.
30 lines
1.2 KiB
ReStructuredText
30 lines
1.2 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.
|
|
|
|
.. |INTRODUCED_IN_CMAKE_VERSION| replace:: 3.0
|
|
.. |WARNS_OR_DOES_NOT_WARN| replace:: warns
|
|
.. include:: STANDARD_ADVICE.txt
|
|
|
|
.. include:: DEPRECATED.txt
|