diff --git a/Help/policy/CMP0189.rst b/Help/policy/CMP0189.rst
index 6f26f2de76..c2a5893136 100644
--- a/Help/policy/CMP0189.rst
+++ b/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`