Merge topic 'doc-CMP0189' into release-4.1

e8d779c935 Help: Document when policy CMP0189 takes effect

Acked-by: Kitware Robot <kwrobot@kitware.com>
Merge-request: !11230
This commit is contained in:
Brad King 2025-09-23 13:13:56 +00:00 committed by Kitware Robot
commit 6201ff1864

View File

@ -14,8 +14,11 @@ transitively. CMake 4.1 and above prefer to evaluate the
target properties transitively because they are among the
:ref:`build specification <Target Build Specification>` and
:ref:`usage requirement <Target Usage Requirements>` properties, respectively.
This policy provides compatibility for projects that have not been updated to
expect the new behavior.
expect the new behavior. It takes effect during buildsystem generation.
Generator expressions are evaluated in each directory using the policy setting
as of the end of its ``CMakeLists.txt``.
The ``OLD`` behavior of this policy is for :genex:`TARGET_PROPERTY` to not
evaluate :prop_tgt:`LINK_LIBRARIES` and :prop_tgt:`INTERFACE_LINK_LIBRARIES`