1CMAKE_IGNORE_PATH
2-----------------
3
4:ref:`Semicolon-separated list <CMake Language Lists>` of directories to be *ignored* by
5the :command:`find_program`, :command:`find_library`, :command:`find_file`,
6and :command:`find_path` commands.  This is useful in cross-compiling
7environments where some system directories contain incompatible but
8possibly linkable libraries.  For example, on cross-compiled cluster
9environments, this allows a user to ignore directories containing
10libraries meant for the front-end machine.
11
12By default this is empty; it is intended to be set by the project.
13Note that ``CMAKE_IGNORE_PATH`` takes a list of directory names, *not*
14a list of prefixes.  To ignore paths under prefixes (``bin``, ``include``,
15``lib``, etc.), specify them explicitly.
16
17See also the :variable:`CMAKE_PREFIX_PATH`, :variable:`CMAKE_LIBRARY_PATH`,
18:variable:`CMAKE_INCLUDE_PATH`, and :variable:`CMAKE_PROGRAM_PATH` variables.
19