[cmake-commits] alex committed cmFindBase.cxx 1.21 1.22

[cmake-commits at cmake.org]

Update of /cvsroot/CMake/CMake/Source
In directory public:/mounts/ram/cvs-serv29394/Source

Modified Files:
	cmFindBase.cxx 
Log Message:

STYLE: add documentation for CMAKE_FIND_ROOT_PATH

Alex


Index: cmFindBase.cxx
===================================================================
RCS file: /cvsroot/CMake/CMake/Source/cmFindBase.cxx,v
retrieving revision 1.21
retrieving revision 1.22
diff -u -d -r1.21 -r1.22
--- cmFindBase.cxx	18 May 2007 12:49:06 -0000	1.21
+++ cmFindBase.cxx	7 Jun 2007 18:57:32 -0000	1.22
@@ -54,6 +54,8 @@
     "             [NO_CMAKE_PATH]\n"
     "             [NO_SYSTEM_ENVIRONMENT_PATH]\n"
     "             [NO_CMAKE_SYSTEM_PATH]\n"
+    "             [CMAKE_FIND_ROOT_PATH_BOTH | ONLY_CMAKE_FIND_ROOT_PATH | "
+                                               "NO_CMAKE_FIND_ROOT_PATH ]\n"
     "            )\n"
     ""
     "This command is used to find a SEARCH_XXX_DESC. "
@@ -122,6 +124,20 @@
     "              programs.\n"
     "   \"ONLY\"   - Only try to find application bundles.\n"
     "   \"NEVER\". - Never try to find application bundles.\n"
+    "\n"
+    "The CMake variable CMAKE_FIND_ROOT_PATH specifies one or more "
+    "directories, which will be prefixed to all of the search directories. "
+    "By default it is empty. It is especially useful if you are "
+    "crosscompiling, then you can point it to the root directory of the "
+    "target environment and CMake will search there too. By default at first "
+    "the directories listed in CMAKE_FIND_ROOT_PATH and then the non-prefixed "
+    "directories will be searched."
+    "The default behaviour can be adjusted by setting "
+    "CMAKE_FIND_ROOT_PATH_MODE_XXX.  This behaviour can be manually "
+    "overwritten. By using CMAKE_FIND_ROOT_PATH_BOTH the search order will "
+    "be as described above. If NO_CMAKE_FIND_ROOT_PATH is used "
+    "then CMAKE_FIND_ROOT_PATH will not be used. If ONLY_CMAKE_FIND_ROOT_PATH "
+    "is used then only the prefixed directories will be searched.\n "
     "The reason the paths listed in the call to the command are searched "
     "last is that most users of CMake would expect things to be found "
     "first in the locations specified by their environment. Projects may "