1
0
mirror of https://github.com/Kitware/CMake.git synced 2025-10-15 20:46:37 +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 specified. If ``REQUIRED`` is specified and the package is not found, a
fatal error is generated and the configure step stops executing. If fatal error is generated and the configure step stops executing. If
``<PackageName>_DIR`` has been set to a directory not containing a ``<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 Package maintainers providing package configuration files are encouraged to
name and install them such that the :ref:`search procedure` outlined below name and install them such that the :ref:`search procedure` outlined below