From 8c03f157765256113928edb5e58ef3a5cf82125c Mon Sep 17 00:00:00 2001 From: Brad King Date: Mon, 28 Jul 2014 12:45:06 -0400 Subject: [PATCH] Help: Clarify target_link_libraries treatment of flags (#15034) Explain that link flags should not be used in transitive contexts. --- Help/command/target_link_libraries.rst | 5 ++++- 1 file changed, 4 insertions(+), 1 deletion(-) diff --git a/Help/command/target_link_libraries.rst b/Help/command/target_link_libraries.rst index bced16917..39537a703 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 ````. A ``debug``, ``optimized``, or ``general`` keyword indicates that the library immediately following it is to be used only for the