mirror of
https://github.com/reactos/CMake.git
synced 2024-12-02 00:26:18 +00:00
482a3bf3f0
The most likely documentation page a project author will read in response to a policy warning is the page for the policy itself. Add to every policy documentation page a note explicitly stating that the OLD behavior is deprecated. Also mention this in the cmake_policy() command documentation that explains how to set a policy to OLD. Suggested-by: Fraser Hutchison <fraser.hutchison@gmail.com>
29 lines
1.2 KiB
ReStructuredText
29 lines
1.2 KiB
ReStructuredText
CMP0026
|
|
-------
|
|
|
|
Disallow use of the LOCATION property for build targets.
|
|
|
|
CMake 2.8.12 and lower allowed reading the 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
|
|
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.
|
|
|
|
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.
|
|
|
|
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.
|
|
|
|
.. include:: DEPRECATED.txt
|