CMP0026.rst 1.2 KB

12345678910111213141516171819202122232425262728
  1. CMP0026
  2. -------
  3. Disallow use of the LOCATION property for build targets.
  4. CMake 2.8.12 and lower allowed reading the LOCATION target
  5. property (and configuration-specific variants) to
  6. determine the eventual location of build targets. This relies on the
  7. assumption that all necessary information is available at
  8. configure-time to determine the final location and filename of the
  9. target. However, this property is not fully determined until later at
  10. generate-time. At generate time, the $<TARGET_FILE> generator
  11. expression can be used to determine the eventual LOCATION of a target
  12. output.
  13. Code which reads the LOCATION target property can be ported to use the
  14. $<TARGET_FILE> generator expression together with the file(GENERATE)
  15. subcommand to generate a file containing the target location.
  16. The OLD behavior for this policy is to allow reading the LOCATION
  17. properties from build-targets. The NEW behavior for this policy is to
  18. not to allow reading the LOCATION properties from build-targets.
  19. This policy was introduced in CMake version 3.0. CMake version
  20. |release| warns when the policy is not set and uses OLD behavior. Use
  21. the cmake_policy command to set it to OLD or NEW explicitly.
  22. .. include:: DEPRECATED.txt