27 lines
1.0 KiB
ReStructuredText
27 lines
1.0 KiB
ReStructuredText
CMAKE_FIND_PACKAGE_NO_PACKAGE_REGISTRY
|
|
--------------------------------------
|
|
|
|
.. versionadded:: 3.1
|
|
|
|
.. deprecated:: 3.16
|
|
|
|
Use the :variable:`CMAKE_FIND_USE_PACKAGE_REGISTRY` variable instead.
|
|
|
|
By default this variable is not set. If neither
|
|
:variable:`CMAKE_FIND_USE_PACKAGE_REGISTRY` nor
|
|
``CMAKE_FIND_PACKAGE_NO_PACKAGE_REGISTRY`` is set, then
|
|
:command:`find_package()` will use the :ref:`User Package Registry`
|
|
unless the ``NO_CMAKE_PACKAGE_REGISTRY`` option is provided.
|
|
|
|
``CMAKE_FIND_PACKAGE_NO_PACKAGE_REGISTRY`` is ignored if
|
|
:variable:`CMAKE_FIND_USE_PACKAGE_REGISTRY` is set.
|
|
|
|
In some cases, for example to locate only system wide installations, it
|
|
is not desirable to use the :ref:`User Package Registry` when searching
|
|
for packages. If the :variable:`CMAKE_FIND_PACKAGE_NO_PACKAGE_REGISTRY`
|
|
variable is ``TRUE``, all the :command:`find_package` commands will skip
|
|
the :ref:`User Package Registry` as if they were called with the
|
|
``NO_CMAKE_PACKAGE_REGISTRY`` argument.
|
|
|
|
See also :ref:`Disabling the Package Registry`.
|