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

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);