| 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 using options: |
| |
| ``CMAKE_FIND_ROOT_PATH_BOTH`` |
| Search in the order described above. |
| |
| ``NO_CMAKE_FIND_ROOT_PATH`` |
| Do not use the :variable:`CMAKE_FIND_ROOT_PATH` variable. |
| |
| ``ONLY_CMAKE_FIND_ROOT_PATH`` |
| Search only the re-rooted directories and directories below |
| :variable:`CMAKE_STAGING_PREFIX`. |
