diff options
| author | Brad King <brad.king@kitware.com> | 2022-01-12 17:14:40 -0500 |
|---|---|---|
| committer | Brad King <brad.king@kitware.com> | 2022-01-29 06:48:13 -0500 |
| commit | f3ad061858d03cc2a0569f903df3560152106050 (patch) | |
| tree | be604880c112a5b7b6eeee586cf2238c4e952c3e /Help/prop_tgt/INTERFACE_LINK_LIBRARIES.rst | |
| parent | 193a999cd5ed345d79b91dae1fd284248ec93ba2 (diff) | |
| download | cmake-f3ad061858d03cc2a0569f903df3560152106050.tar.gz | |
Add usage requirements to update direct link dependencies
Link line construction starts with `LINK_LIBRARIES` and appends
dependencies from the transitive closure of `INTERFACE_LINK_LIBRARIES`.
Only the entries of `LINK_LIBRARIES` are considered direct link
dependencies. In some advanced use cases, particularly involving static
libraries and static plugins, usage requirements need to update the list
of direct link dependencies. This may mean adding new items, removing
existing items, or both.
Add target properties to encode these usage requirements:
* INTERFACE_LINK_LIBRARIES_DIRECT
* INTERFACE_LINK_LIBRARIES_DIRECT_EXCLUDE
Fixes: #22496
Diffstat (limited to 'Help/prop_tgt/INTERFACE_LINK_LIBRARIES.rst')
| -rw-r--r-- | Help/prop_tgt/INTERFACE_LINK_LIBRARIES.rst | 6 |
1 files changed, 6 insertions, 0 deletions
diff --git a/Help/prop_tgt/INTERFACE_LINK_LIBRARIES.rst b/Help/prop_tgt/INTERFACE_LINK_LIBRARIES.rst index af3d9c2c3e..53f5838f7a 100644 --- a/Help/prop_tgt/INTERFACE_LINK_LIBRARIES.rst +++ b/Help/prop_tgt/INTERFACE_LINK_LIBRARIES.rst @@ -26,6 +26,12 @@ 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 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ |