ENH: Improved support for user-configured search paths. Paths given in the CMAKE_LIBRARY_PATH cmake variable are searched first, then those in the CMAKE_LIBRARY_PATH environment variable, then those listed in the call to the FIND_LIBRARY command and finally those listed in the PATH environment variable. The support is similar for finding include files with FIND_PATH, but the variable is CMAKE_INCLUDE_PATH.

1 files changed, 7 insertions, 4 deletions

diff --git a/Source/cmFindLibraryCommand.h b/Source/cmFindLibraryCommand.h
index b5f0f7beb8..885405dd2f 100644
--- a/Source/cmFindLibraryCommand.h
+++ b/Source/cmFindLibraryCommand.h
@@ -72,8 +72,7 @@ public:
       "               [PATHS path1 path2 ...]\n"
       "               [DOC \"docstring\"])\n"
       "Find a library named by one of the names given after the NAMES "
-      "argument.  Paths specified after the PATHS argument are searched "
-      "in the order specified.  A cache entry named by <VAR> is created "
+      "argument.  A cache entry named by <VAR> is created "
       "to store the result.  If the library is not found, the result "
       "will be <VAR>-NOTFOUND.  If DOC is specified then the next "
       "argument is treated as a documentation string for the cache "
@@ -81,8 +80,12 @@ public:
       "  FIND_LIBRARY(VAR libraryName [path1 path2 ...])\n"
       "Find a library with the given name by searching in the specified "
       "paths.  This is a short-hand signature for the command that is "
-      "sufficient in many cases.  The environment variable CMAKE_LIBRARY_PATH "
-      "is searched as well as the PATH variable.\n";
+      "sufficient in many cases.  "
+      "The search proceeds first in paths listed in the CMAKE_LIBRARY_PATH "
+      "CMake variable (which is generally set by the user on the command line), "
+      "then in paths listed in the CMAKE_LIBRARY_PATH environment variable, "
+      "then in paths given to the PATHS option of the command, "
+      "and finally in paths listed in the PATH environment variable.";
     }
   
   cmTypeMacro(cmFindLibraryCommand, cmCommand);