1The CMake variable :variable:`CMAKE_FIND_ROOT_PATH` specifies one or more
2directories to be prepended to all other search directories.  This
3effectively "re-roots" the entire search under given locations.
4Paths which are descendants of the :variable:`CMAKE_STAGING_PREFIX` are excluded
5from this re-rooting, because that variable is always a path on the host system.
6By default the :variable:`CMAKE_FIND_ROOT_PATH` is empty.
7
8The :variable:`CMAKE_SYSROOT` variable can also be used to specify exactly one
9directory to use as a prefix.  Setting :variable:`CMAKE_SYSROOT` also has other
10effects.  See the documentation for that variable for more.
11
12These variables are especially useful when cross-compiling to
13point to the root directory of the target environment and CMake will
14search there too.  By default at first the directories listed in
15:variable:`CMAKE_FIND_ROOT_PATH` are searched, then the :variable:`CMAKE_SYSROOT`
16directory is searched, and then the non-rooted directories will be
17searched.  The default behavior can be adjusted by setting
18|CMAKE_FIND_ROOT_PATH_MODE_XXX|.  This behavior can be manually
19overridden on a per-call basis using options:
20
21``CMAKE_FIND_ROOT_PATH_BOTH``
22  Search in the order described above.
23
24``NO_CMAKE_FIND_ROOT_PATH``
25  Do not use the :variable:`CMAKE_FIND_ROOT_PATH` variable.
26
27``ONLY_CMAKE_FIND_ROOT_PATH``
28  Search only the re-rooted directories and directories below
29  :variable:`CMAKE_STAGING_PREFIX`.
30