Files
CMake/Help/variable/CMAKE_SYSTEM_IGNORE_PREFIX_PATH.rst
Brad King 9334b5bd7b Help: Update Sphinx versionadded directives for 3.23 release
Run the script:

    Utilities/Sphinx/update_versions.py --since v3.22.0 --overwrite

Manually select updates that really belong to the 3.23 release, as
against adding documentation for previously-existing entities.
2022-02-03 07:53:46 -05:00

21 lines
994 B
ReStructuredText

CMAKE_SYSTEM_IGNORE_PREFIX_PATH
-------------------------------
.. versionadded:: 3.23
:ref:`Semicolon-separated list <CMake Language Lists>` of prefixes 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 contains a list of directories containing incompatible
binaries for the host system. See the :variable:`CMAKE_IGNORE_PREFIX_PATH`
variable that is intended to be set by the project and/or the end user.
See also the :variable:`CMAKE_SYSTEM_PREFIX_PATH`,
:variable:`CMAKE_SYSTEM_LIBRARY_PATH`, :variable:`CMAKE_SYSTEM_INCLUDE_PATH`,
and :variable:`CMAKE_SYSTEM_PROGRAM_PATH` variables.