You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
20 lines
1.1 KiB
20 lines
1.1 KiB
3 years ago
|
:ref:`Semicolon-separated list <CMake Language Lists>` of directories
|
||
|
|
to be ignored by the various ``find...()`` commands.
|
||
|
|
|
||
|
|
For :command:`find_program`, :command:`find_library`, :command:`find_file`,
|
||
|
|
and :command:`find_path`, any file found in one of the listed directories
|
||
|
|
will be ignored. The listed directories do not apply recursively, so any
|
||
|
|
subdirectories to be ignored must also be explicitly listed.
|
||
|
|
|CMAKE_IGNORE_VAR| does not affect the search *prefixes* used by these
|
||
|
|
four commands. To ignore individual paths under a search prefix
|
||
|
|
(e.g. ``bin``, ``include``, ``lib``, etc.), each path must be listed in
|
||
|
|
|CMAKE_IGNORE_VAR| as a full absolute path. |CMAKE_IGNORE_PREFIX_VAR|
|
||
|
|
provides a more appropriate way to ignore a whole search prefix.
|
||
|
|
|
||
|
|
:command:`find_package` is also affected by |CMAKE_IGNORE_VAR|, but only
|
||
|
|
for *Config mode* searches. Any ``<Name>Config.cmake`` or
|
||
|
|
``<name>-config.cmake`` file found in one of the specified directories
|
||
|
|
will be ignored. In addition, any search *prefix* found in |CMAKE_IGNORE_VAR|
|
||
|
|
will be skipped for backward compatibility reasons, but new code should
|
||
|
|
prefer to use |CMAKE_IGNORE_PREFIX_VAR| to ignore prefixes instead.
|