summaryrefslogtreecommitdiffstats
path: root/Help/command
diff options
context:
space:
mode:
authorBrad King <brad.king@kitware.com>2013-11-19 17:41:57 (GMT)
committerCMake Topic Stage <kwrobot@kitware.com>2013-11-19 17:41:57 (GMT)
commit46ec48c93d2d84cf79c8704c370e24d47a7536a5 (patch)
tree83dae82226242d9f31dfc8f77edf791d34cc65b4 /Help/command
parent1da77bf1ee4f3ba315ebb00da2eaeac474614cad (diff)
parent7cd65c97fabd9f3249739a81dd1260a1e0b59ee1 (diff)
downloadCMake-46ec48c93d2d84cf79c8704c370e24d47a7536a5.zip
CMake-46ec48c93d2d84cf79c8704c370e24d47a7536a5.tar.gz
CMake-46ec48c93d2d84cf79c8704c370e24d47a7536a5.tar.bz2
Merge topic 'cross-compiling-toolchain-variables'
7cd65c9 Add CMAKE_SYSROOT variable to set --sysroot when cross compiling. 5096967 Allow toolchain files to specify an external toolchain. 76552d5 Add compiler target compile options. f41ecd1 CMakeDetermineCompilerId: Look for internal file only on host
Diffstat (limited to 'Help/command')
-rw-r--r--Help/command/FIND_XXX_ROOT.txt11
1 files changed, 9 insertions, 2 deletions
diff --git a/Help/command/FIND_XXX_ROOT.txt b/Help/command/FIND_XXX_ROOT.txt
index 407375a..7f80dcb 100644
--- a/Help/command/FIND_XXX_ROOT.txt
+++ b/Help/command/FIND_XXX_ROOT.txt
@@ -1,10 +1,17 @@
The CMake variable CMAKE_FIND_ROOT_PATH specifies one or more
directories to be prepended to all other search directories. This
effectively "re-roots" the entire search under given locations. By
-default it is empty. It is especially useful when cross-compiling to
+default it is empty.
+
+The :variable:`CMAKE_SYSROOT` variable can also be used to specify exactly one
+directory to use as a prefix. Setting :variable:`CMAKE_SYSROOT` also has other
+effects. See the documentation for that variable for more.
+
+These variables are especially useful when cross-compiling to
point 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-rooted directories will be
+CMAKE_FIND_ROOT_PATH are searched, then the :variable:`CMAKE_SYSROOT` directory is
+searched, and then the non-rooted directories will be
searched. The default behavior can be adjusted by setting
|CMAKE_FIND_ROOT_PATH_MODE_XXX|. This behavior can be manually
overridden on a per-call basis. By using CMAKE_FIND_ROOT_PATH_BOTH