Document target_link_libraries target scope (#11058)

The target_link_libraries command requires its first argument to be a
target in the current directory.  Document this and update the error
message to be more specific.  While at it, format the error message with
a call stack.

1 files changed, 4 insertions, 0 deletions

diff --git a/Source/cmTargetLinkLibrariesCommand.h b/Source/cmTargetLinkLibrariesCommand.h
index 43a0d7ce39..ce57df7f2a 100644
--- a/Source/cmTargetLinkLibrariesCommand.h
+++ b/Source/cmTargetLinkLibrariesCommand.h
@@ -62,6 +62,10 @@ public:
       "  target_link_libraries(<target> [item1 [item2 [...]]]\n"
       "                        [[debug|optimized|general] <item>] ...)\n"
       "Specify libraries or flags to use when linking a given target.  "
+      "The named <target> must have been created in the current directory "
+      "by a command such as add_executable or add_library.  "
+      "The remaining arguments specify library names or flags."
+      "\n"
       "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.  "