diff options
Diffstat (limited to 'Help/variable/CMAKE_IGNORE_PREFIX_PATH.rst')
| -rw-r--r-- | Help/variable/CMAKE_IGNORE_PREFIX_PATH.rst | 17 |
1 files changed, 17 insertions, 0 deletions
diff --git a/Help/variable/CMAKE_IGNORE_PREFIX_PATH.rst b/Help/variable/CMAKE_IGNORE_PREFIX_PATH.rst new file mode 100644 index 0000000..45e51dd --- /dev/null +++ b/Help/variable/CMAKE_IGNORE_PREFIX_PATH.rst @@ -0,0 +1,17 @@ +CMAKE_IGNORE_PREFIX_PATH +------------------------ + +:ref:`Semicolon-separated list <CMake Language Lists>` of prefix to be *ignored* by +the :command:`find_program`, :command:`find_library`, :command:`find_file`, +:command:`find_path`, and :command:`find_package` commands. This is useful in cross-compiling +environments where some system directories contain incompatible but +possibly linkable libraries. For example, on cross-compiled cluster +environments, this allows a user to ignore directories containing +libraries meant for the front-end machine. + +By default this is empty; it is intended to be set by the project. +Note that ``CMAKE_IGNORE_PREFIX_PATH`` takes a list of prefixes, *not* +a list of directory names. + +See also the :variable:`CMAKE_PREFIX_PATH`, :variable:`CMAKE_LIBRARY_PATH`, +:variable:`CMAKE_INCLUDE_PATH`, and :variable:`CMAKE_PROGRAM_PATH` variables. |