mirror of
https://github.com/Kitware/CMake.git
synced 2026-05-07 22:59:56 -05:00
Brad King
687a91967f
Revert commitf3ad061858(Add usage requirements to update direct link dependencies, 2022-01-12, v3.23.0-rc1~44^2) and the property storage updates in its predecessor commit193a999cd5(cmTarget: Add INTERFACE_LINK_LIBRARIES_DIRECT{,_EXCLUDE} backtrace storage, 2022-01-06, v3.23.0-rc1~44^2~1) from the 3.23 release branch. After initial experience using the feature in practice, additional design considerations have been raised for discussion in the original issue. To avoid rushing this for the 3.23 series, we've decided to revert the feature for now so it can be revised for a future release. Issue: #22496
40 lines
1.7 KiB
ReStructuredText
40 lines
1.7 KiB
ReStructuredText
INTERFACE_LINK_LIBRARIES
|
|
------------------------
|
|
|
|
List public interface libraries for a library.
|
|
|
|
This property contains the list of transitive link dependencies. When
|
|
the target is linked into another target using the
|
|
:command:`target_link_libraries` command, the libraries listed (and
|
|
recursively their link interface libraries) will be provided to the
|
|
other target also. This property is overridden by the
|
|
:prop_tgt:`LINK_INTERFACE_LIBRARIES` or
|
|
:prop_tgt:`LINK_INTERFACE_LIBRARIES_<CONFIG>` property if policy
|
|
:policy:`CMP0022` is ``OLD`` or unset.
|
|
|
|
The value of this property is used by the generators when constructing
|
|
the link rule for a dependent target. A dependent target's direct
|
|
link dependencies, specified by its :prop_tgt:`LINK_LIBRARIES` target
|
|
property, are linked first, followed by indirect dependencies from the
|
|
transitive closure of the direct dependencies'
|
|
``INTERFACE_LINK_LIBRARIES`` properties. See policy :policy:`CMP0022`.
|
|
|
|
Contents of ``INTERFACE_LINK_LIBRARIES`` may use "generator expressions"
|
|
with the syntax ``$<...>``. See the :manual:`cmake-generator-expressions(7)`
|
|
manual for available expressions. See the :manual:`cmake-buildsystem(7)`
|
|
manual for more on defining buildsystem properties.
|
|
|
|
.. include:: LINK_LIBRARIES_INDIRECTION.txt
|
|
|
|
``INTERFACE_LINK_LIBRARIES`` adds transitive link dependencies for a
|
|
target's dependents. In advanced use cases, one may update the
|
|
direct link dependencies of a target's dependents by using the
|
|
:prop_tgt:`INTERFACE_LINK_LIBRARIES_DIRECT` and
|
|
:prop_tgt:`INTERFACE_LINK_LIBRARIES_DIRECT_EXCLUDE` target properties.
|
|
|
|
Creating Relocatable Packages
|
|
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
|
|
|
|
.. |INTERFACE_PROPERTY_LINK| replace:: ``INTERFACE_LINK_LIBRARIES``
|
|
.. include:: /include/INTERFACE_LINK_LIBRARIES_WARNING.txt
|