STYLE: Improve documentation of target_link_libraries command to make target-level dependency explicit. See bug #6043.

1 files changed, 4 insertions, 1 deletions

diff --git a/Source/cmTargetLinkLibrariesCommand.h b/Source/cmTargetLinkLibrariesCommand.h
index 1e2cac1..de20533 100644
--- a/Source/cmTargetLinkLibrariesCommand.h
+++ b/Source/cmTargetLinkLibrariesCommand.h
@@ -71,7 +71,10 @@ public:
       "The debug and optimized strings may be used to indicate that "
       "the next library listed is to be used only for that specific "
       "type of build. general indicates it is used for all build types "
-      "and is assumed if not specified.";
+      "and is assumed if not specified.\n"
+      "If any library name matches that of a target in the current 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.";
     }
   
   cmTypeMacro(cmTargetLinkLibrariesCommand, cmCommand);