mirror of
https://github.com/Kitware/CMake.git
synced 2026-01-06 13:51:33 -06:00
a1ad0a699b
Previously the command did not allow naming targets on the LHS that were not created in the calling directory. Lift this restriction to enable more flexible use by projects. Targets named on the RHS will need to be looked up during generation in the scope of the call site rather than the scope of the LHS target. Introduce an internal syntax in `[INTERFACE_]LINK_LIBRARIES` properties to specify target names that need to be looked up in a directory other than that containing the target on which the property is set. Add minimal documentation of the syntax to help users that encounter it. Unfortunately CMake previously did allow such calls in the case that only `INTERFACE` libraries are specified, but those libraries would be looked up in the target's directory rather than the caller's. Add policy `CMP0079` to enable the new behavior with new lookup scope in a compatible way. Fixes: #17943
20 lines
734 B
ReStructuredText
20 lines
734 B
ReStructuredText
LINK_LIBRARIES
|
|
--------------
|
|
|
|
List of direct link dependencies.
|
|
|
|
This property specifies the list of libraries or targets which will be
|
|
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.
|
|
|
|
Contents of ``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
|