diff options
| author | Brad King <brad.king@kitware.com> | 2014-07-28 16:45:06 (GMT) |
|---|---|---|
| committer | Brad King <brad.king@kitware.com> | 2014-07-28 16:45:06 (GMT) |
| commit | 8c03f157765256113928edb5e58ef3a5cf82125c (patch) | |
| tree | bd2a0f686896251a792f2def5555653aeb76da07 /Help | |
| parent | f188845237cdfee74dae0658888a61c855e285b3 (diff) | |
| download | CMake-8c03f157765256113928edb5e58ef3a5cf82125c.zip CMake-8c03f157765256113928edb5e58ef3a5cf82125c.tar.gz CMake-8c03f157765256113928edb5e58ef3a5cf82125c.tar.bz2 | |
Help: Clarify target_link_libraries treatment of flags (#15034)
Explain that link flags should not be used in transitive contexts.
Diffstat (limited to 'Help')
| -rw-r--r-- | Help/command/target_link_libraries.rst | 5 |
1 files changed, 4 insertions, 1 deletions
diff --git a/Help/command/target_link_libraries.rst b/Help/command/target_link_libraries.rst index bced169..39537a7 100644 --- a/Help/command/target_link_libraries.rst +++ b/Help/command/target_link_libraries.rst @@ -18,7 +18,10 @@ If a library name matches that of another target in the project a dependency will automatically be added in the build system to make sure the library being linked is up-to-date before the target links. Item names starting with ``-``, but not ``-l`` or ``-framework``, are treated as -linker flags. +linker flags. Note that such flags will be treated like any other library +link item for purposes of transitive dependencies, so they are generally +safe to specify only as private link items that will not propagate to +dependents of ``<target>``. A ``debug``, ``optimized``, or ``general`` keyword indicates that the library immediately following it is to be used only for the |