diff options
| author | Brad King <brad.king@kitware.com> | 2021-07-12 12:43:25 (GMT) |
|---|---|---|
| committer | Kitware Robot <kwrobot@kitware.com> | 2021-07-12 12:43:32 (GMT) |
| commit | c9cd039e5f312f2717c6522ac7117791856f734b (patch) | |
| tree | b58053d2319951dbff155e1453d1fe3969065403 /Help/prop_tgt | |
| parent | 2d830247bae808cc68f26288ff72768b21d0c102 (diff) | |
| parent | 14e57e9637964594461711954c6c906bc22eb7c7 (diff) | |
| download | CMake-c9cd039e5f312f2717c6522ac7117791856f734b.zip CMake-c9cd039e5f312f2717c6522ac7117791856f734b.tar.gz CMake-c9cd039e5f312f2717c6522ac7117791856f734b.tar.bz2 | |
Merge topic 'LWYU-externalization'
14e57e9637 LINK_WHAT_YOU_USE feature: externalize configuration
9c5132a586 PGI: Fix "LINKER:" prefix generated separator
8a93de080c cmGeneratorTarget: Add method for LINKER: prefix translation
Acked-by: Kitware Robot <kwrobot@kitware.com>
Merge-request: !6306
Diffstat (limited to 'Help/prop_tgt')
| -rw-r--r-- | Help/prop_tgt/LINK_WHAT_YOU_USE.rst | 24 |
1 files changed, 15 insertions, 9 deletions
diff --git a/Help/prop_tgt/LINK_WHAT_YOU_USE.rst b/Help/prop_tgt/LINK_WHAT_YOU_USE.rst index 2ed93ad..d6de0d4 100644 --- a/Help/prop_tgt/LINK_WHAT_YOU_USE.rst +++ b/Help/prop_tgt/LINK_WHAT_YOU_USE.rst @@ -1,16 +1,22 @@ LINK_WHAT_YOU_USE ---------------------------- +----------------- .. versionadded:: 3.7 -This is a boolean option that when set to ``TRUE`` will automatically run -``ldd -r -u`` on the target after it is linked. In addition, the linker flag -``-Wl,--no-as-needed`` will be passed to the target with the link command so -that all libraries specified on the command line will be linked into the -target. This will result in the link producing a list of libraries that -provide no symbols used by this target but are being linked to it. -This is only applicable to executable and shared library targets and -will only work when ld and ldd accept the flags used. +This is a boolean option that, when set to ``TRUE``, will automatically run +contents of variable :variable:`CMAKE_LINK_WHAT_YOU_USE_CHECK` on the target +after it is linked. In addition, the linker flag specified by variable +:variable:`CMAKE_<LANG>_LINK_WHAT_YOU_USE_FLAG` will be passed to the target +with the link command so that all libraries specified on the command line will +be linked into the target. This will result in the link producing a list of +libraries that provide no symbols used by this target but are being linked to +it. + +.. note:: + + For now, it is only supported for ``ELF`` platforms and is only applicable to + executable and shared or module library targets. This property will be + ignored for any other targets and configurations. This property is initialized by the value of the :variable:`CMAKE_LINK_WHAT_YOU_USE` variable if it is set |