mirror of
https://github.com/Kitware/CMake.git
synced 2026-04-26 00:00:39 -05:00
Brad King
deb7b4b658
Policy CMP0189, introduced by commit b3da9c6d60 (GenEx: Evaluate
LINK_LIBRARIES target properties transitively, 2025-02-24,
v4.1.0-rc1~731^2), takes effect at generation time, and so uses the
policy value as of the end of each directory. However, some projects
may rely on `file(GENERATE)` with the policy's OLD behavior in order
to extract targets' *direct* dependencies from `LINK_LIBRARIES`.
Pending a first-class solution to that problem, make it easier for
projects to port to the policy's NEW behavior in general while
retaining the OLD behavior in an isolated context.
Fixes: #27220
36 lines
1.6 KiB
ReStructuredText
36 lines
1.6 KiB
ReStructuredText
CMP0189
|
|
-------
|
|
|
|
.. versionadded:: 4.1
|
|
|
|
:genex:`TARGET_PROPERTY` evaluates ``LINK_LIBRARIES`` properties transitively.
|
|
|
|
The :prop_tgt:`LINK_LIBRARIES` and :prop_tgt:`INTERFACE_LINK_LIBRARIES`
|
|
target properties record link dependencies through which the
|
|
:genex:`TARGET_PROPERTY` generator expression evaluates transitive properties.
|
|
However, in CMake 4.0 and below, the properties themselves were not evaluated
|
|
transitively. CMake 4.1 and above prefer to evaluate the
|
|
:prop_tgt:`LINK_LIBRARIES` and :prop_tgt:`INTERFACE_LINK_LIBRARIES`
|
|
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. 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``. As an exception, generator
|
|
expressions evaluated by the :command:`file(GENERATE)` command use the
|
|
policy setting as of its call site.
|
|
|
|
The ``OLD`` behavior of this policy is for :genex:`TARGET_PROPERTY` to not
|
|
evaluate :prop_tgt:`LINK_LIBRARIES` and :prop_tgt:`INTERFACE_LINK_LIBRARIES`
|
|
transitively. The ``NEW`` behavior is for :genex:`TARGET_PROPERTY` to
|
|
evaluate :prop_tgt:`LINK_LIBRARIES` and :prop_tgt:`INTERFACE_LINK_LIBRARIES`
|
|
transitively.
|
|
|
|
.. |INTRODUCED_IN_CMAKE_VERSION| replace:: 4.1
|
|
.. |WARNS_OR_DOES_NOT_WARN| replace:: does *not* warn
|
|
.. include:: include/STANDARD_ADVICE.rst
|
|
|
|
.. include:: include/DEPRECATED.rst
|