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, 8 insertions, 4 deletions

diff --git a/Source/cmFindPathCommand.h b/Source/cmFindPathCommand.h
index 17e431b..3c44221 100644
--- a/Source/cmFindPathCommand.h
+++ b/Source/cmFindPathCommand.h
@@ -70,13 +70,17 @@ public:
     return
       "  FIND_PATH(<VAR> fileName path1 [path2 ...]\n"
       "            [DOC \"docstring\"])\n"
-      "Find the directory containing a file named by fileName.  Paths "
-      "are searched in the order specified.  A cache entry named by "
+      "Find the directory containing a file named by fileName.  "
+      "A cache entry named by "
       "<VAR> is created to store the result.  If the file 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 entry <VAR>.  The environment variable CMAKE_INCLUDE_PATH "
-      "is searched as well as the PATH variable.\n";
+      "the cache entry <VAR>.  "
+      "The search proceeds first in paths listed in the CMAKE_INCLUDE_PATH "
+      "CMake variable (which is generally set by the user on the command line), "
+      "then in paths listed in the CMAKE_INCLUDE_PATH environment variable, "
+      "then in paths given to the command, and finally in paths listed in the "
+      "PATH environment variable.";
     }
   cmStdString FindHeaderInFrameworks( std::vector<std::string> path,
                                       const char* var, const char* file);