Merge topic 'doc-CMP0189' into release-4.1

e8d779c935 Help: Document when policy CMP0189 takes effect

Acked-by: Kitware Robot <[email protected]>
Merge-request: !11230

Help/policy/CMP0189.rst

@@ -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`