1
0
mirror of https://github.com/Kitware/CMake.git synced 2025-10-14 19:08:07 +08:00

Help: Specify <PackageName>_DIR interaction with a version

Explicitly state that if `<PackageName>_DIR` is set, but the version of
the package found there does not match the requested version, then
`find_package` will ignore that directory and continue searching.
This commit is contained in:
Meszaros, Gergely
2025-08-26 07:58:03 +00:00
parent 1cb225d90f
commit f104bdb3b9

View File

@@ -338,7 +338,9 @@ an error describing the problem unless the ``QUIET`` argument is
specified. If ``REQUIRED`` is specified and the package is not found, a
fatal error is generated and the configure step stops executing. If
``<PackageName>_DIR`` has been set to a directory not containing a
configuration file, CMake will ignore it and search from scratch.
configuration file, or if the requested version is not compatible
with the package found in that directory (see :ref:`version selection`),
CMake will ignore it and search from scratch.
Package maintainers providing package configuration files are encouraged to
name and install them such that the :ref:`search procedure` outlined below