| The CMake variable :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. |
| Paths which are descendants of the :variable:`CMAKE_STAGING_PREFIX` are excluded |
| from this re-rooting, because that variable is always a path on the host system. |
| By default the :variable:`CMAKE_FIND_ROOT_PATH` 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 |
| :variable:`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 |
| the search order will be as described above. If |
| NO_CMAKE_FIND_ROOT_PATH is used then :variable:`CMAKE_FIND_ROOT_PATH` will not be |
| used. If ONLY_CMAKE_FIND_ROOT_PATH is used then only the re-rooted |
| directories and directories below :variable:`CMAKE_STAGING_PREFIX` will be searched. |