diff options
author | Brad King <brad.king@kitware.com> | 2022-01-20 09:17:24 -0500 |
---|---|---|
committer | Brad King <brad.king@kitware.com> | 2022-01-29 06:48:12 -0500 |
commit | d2f4f17b90a2a37911d256684447d0bfabc7d295 (patch) | |
tree | 943f4679a31877eb72eb115319a92a4c00dff842 /Help/prop_tgt | |
parent | 4e8f24e9778e4f5d69862efa109d7f8284d1a119 (diff) | |
download | cmake-d2f4f17b90a2a37911d256684447d0bfabc7d295.tar.gz |
Help: Cross-reference LINK_LIBRARIES and INTERFACE_LINK_LIBRARIES
Document in each property its role in combination with the other.
Diffstat (limited to 'Help/prop_tgt')
-rw-r--r-- | Help/prop_tgt/INTERFACE_LINK_LIBRARIES.rst | 7 | ||||
-rw-r--r-- | Help/prop_tgt/LINK_LIBRARIES.rst | 7 |
2 files changed, 12 insertions, 2 deletions
diff --git a/Help/prop_tgt/INTERFACE_LINK_LIBRARIES.rst b/Help/prop_tgt/INTERFACE_LINK_LIBRARIES.rst index bf7f72f4c5..af3d9c2c3e 100644 --- a/Help/prop_tgt/INTERFACE_LINK_LIBRARIES.rst +++ b/Help/prop_tgt/INTERFACE_LINK_LIBRARIES.rst @@ -12,6 +12,13 @@ other target also. This property is overridden by the :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)` diff --git a/Help/prop_tgt/LINK_LIBRARIES.rst b/Help/prop_tgt/LINK_LIBRARIES.rst index d88e79881b..29baf8c442 100644 --- a/Help/prop_tgt/LINK_LIBRARIES.rst +++ b/Help/prop_tgt/LINK_LIBRARIES.rst @@ -8,8 +8,11 @@ used for linking. In addition to accepting values from the :command:`target_link_libraries` command, values may be set directly on any target using the :command:`set_property` command. -The value of this property is used by the generators to set the link -libraries for the compiler. +The value of this property is used by the generators to construct the +link rule for the target. The direct link dependencies are linked first, +followed by indirect dependencies from the transitive closure of the +direct dependencies' :prop_tgt:`INTERFACE_LINK_LIBRARIES` properties. +See policy :policy:`CMP0022`. Contents of ``LINK_LIBRARIES`` may use "generator expressions" with the syntax ``$<...>``. See the :manual:`cmake-generator-expressions(7)` manual |