Commit 30d08bdc authored by Jean-Christophe Fillion-Robin's avatar Jean-Christophe Fillion-Robin Committed by Craig Scott

doc: Consistently use <PackageName> for describing the name of a package

parent eba2b13a
...@@ -51,15 +51,15 @@ unspecified. ...@@ -51,15 +51,15 @@ unspecified.
:: ::
export(PACKAGE <name>) export(PACKAGE <PackageName>)
Store the current build directory in the CMake user package registry Store the current build directory in the CMake user package registry
for package ``<name>``. The find_package command may consider the for package ``<PackageName>``. The find_package command may consider the
directory while searching for package ``<name>``. This helps dependent directory while searching for package ``<PackageName>``. This helps dependent
projects find and use a package from the current project's build tree projects find and use a package from the current project's build tree
without help from the user. Note that the entry in the package without help from the user. Note that the entry in the package
registry that this command creates works only in conjunction with a registry that this command creates works only in conjunction with a
package configuration file (``<name>Config.cmake``) that works with the package configuration file (``<PackageName>Config.cmake``) that works with the
build tree. In some cases, for example for packaging and for system build tree. In some cases, for example for packaging and for system
wide installations, it is not desirable to write the user package wide installations, it is not desirable to write the user package
registry. If the :variable:`CMAKE_EXPORT_NO_PACKAGE_REGISTRY` variable registry. If the :variable:`CMAKE_EXPORT_NO_PACKAGE_REGISTRY` variable
......
...@@ -5,12 +5,12 @@ Load settings for an external project. ...@@ -5,12 +5,12 @@ Load settings for an external project.
:: ::
find_package(<package> [version] [EXACT] [QUIET] [MODULE] find_package(<PackageName> [version] [EXACT] [QUIET] [MODULE]
[REQUIRED] [[COMPONENTS] [components...]] [REQUIRED] [[COMPONENTS] [components...]]
[OPTIONAL_COMPONENTS components...] [OPTIONAL_COMPONENTS components...]
[NO_POLICY_SCOPE]) [NO_POLICY_SCOPE])
Finds and loads settings from an external project. ``<package>_FOUND`` Finds and loads settings from an external project. ``<PackageName>_FOUND``
will be set to indicate whether the package was found. When the will be set to indicate whether the package was found. When the
package is found package-specific information is provided through package is found package-specific information is provided through
variables and :ref:`Imported Targets` documented by the package itself. The variables and :ref:`Imported Targets` documented by the package itself. The
...@@ -44,7 +44,7 @@ are encouraged to read on. ...@@ -44,7 +44,7 @@ are encouraged to read on.
The command has two modes by which it searches for packages: "Module" The command has two modes by which it searches for packages: "Module"
mode and "Config" mode. Module mode is available when the command is mode and "Config" mode. Module mode is available when the command is
invoked with the above reduced signature. CMake searches for a file invoked with the above reduced signature. CMake searches for a file
called ``Find<package>.cmake`` in the :variable:`CMAKE_MODULE_PATH` called ``Find<PackageName>.cmake`` in the :variable:`CMAKE_MODULE_PATH`
followed by the CMake installation. If the file is found, it is read followed by the CMake installation. If the file is found, it is read
and processed by CMake. It is responsible for finding the package, and processed by CMake. It is responsible for finding the package,
checking the version, and producing any needed messages. Many checking the version, and producing any needed messages. Many
...@@ -54,7 +54,7 @@ option is not given the command proceeds to Config mode. ...@@ -54,7 +54,7 @@ option is not given the command proceeds to Config mode.
The complete Config mode command signature is:: The complete Config mode command signature is::
find_package(<package> [version] [EXACT] [QUIET] find_package(<PackageName> [version] [EXACT] [QUIET]
[REQUIRED] [[COMPONENTS] [components...]] [REQUIRED] [[COMPONENTS] [components...]]
[CONFIG|NO_MODULE] [CONFIG|NO_MODULE]
[NO_POLICY_SCOPE] [NO_POLICY_SCOPE]
...@@ -82,29 +82,29 @@ mode is also implied by use of options not specified in the reduced ...@@ -82,29 +82,29 @@ mode is also implied by use of options not specified in the reduced
signature. signature.
Config mode attempts to locate a configuration file provided by the Config mode attempts to locate a configuration file provided by the
package to be found. A cache entry called ``<package>_DIR`` is created to package to be found. A cache entry called ``<PackageName>_DIR`` is created to
hold the directory containing the file. By default the command hold the directory containing the file. By default the command
searches for a package with the name ``<package>``. If the ``NAMES`` option searches for a package with the name ``<PackageName>``. If the ``NAMES`` option
is given the names following it are used instead of ``<package>``. The is given the names following it are used instead of ``<PackageName>``.
command searches for a file called ``<name>Config.cmake`` or The command searches for a file called ``<PackageName>Config.cmake`` or
``<lower-case-name>-config.cmake`` for each name specified. A ``<lower-case-package-name>-config.cmake`` for each name specified.
replacement set of possible configuration file names may be given A replacement set of possible configuration file names may be given
using the ``CONFIGS`` option. The search procedure is specified below. using the ``CONFIGS`` option. The search procedure is specified below.
Once found, the configuration file is read and processed by CMake. Once found, the configuration file is read and processed by CMake.
Since the file is provided by the package it already knows the Since the file is provided by the package it already knows the
location of package contents. The full path to the configuration file location of package contents. The full path to the configuration file
is stored in the cmake variable ``<package>_CONFIG``. is stored in the cmake variable ``<PackageName>_CONFIG``.
All configuration files which have been considered by CMake while All configuration files which have been considered by CMake while
searching for an installation of the package with an appropriate searching for an installation of the package with an appropriate
version are stored in the cmake variable ``<package>_CONSIDERED_CONFIGS``, version are stored in the cmake variable ``<PackageName>_CONSIDERED_CONFIGS``,
the associated versions in ``<package>_CONSIDERED_VERSIONS``. the associated versions in ``<PackageName>_CONSIDERED_VERSIONS``.
If the package configuration file cannot be found CMake will generate If the package configuration file cannot be found CMake will generate
an error describing the problem unless the ``QUIET`` argument is 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
``<package>_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 CMake will ignore it and search from scratch.
When the ``[version]`` argument is given Config mode will only find a When the ``[version]`` argument is given Config mode will only find a
...@@ -127,7 +127,7 @@ version file is loaded in a nested scope in which the following ...@@ -127,7 +127,7 @@ version file is loaded in a nested scope in which the following
variables have been defined: variables have been defined:
``PACKAGE_FIND_NAME`` ``PACKAGE_FIND_NAME``
the ``<package>`` name the ``<PackageName>``
``PACKAGE_FIND_VERSION`` ``PACKAGE_FIND_VERSION``
full requested version string full requested version string
``PACKAGE_FIND_VERSION_MAJOR`` ``PACKAGE_FIND_VERSION_MAJOR``
...@@ -158,17 +158,17 @@ whether the configuration file provides an acceptable version. They ...@@ -158,17 +158,17 @@ whether the configuration file provides an acceptable version. They
are not available after the find_package call returns. If the version are not available after the find_package call returns. If the version
is acceptable the following variables are set: is acceptable the following variables are set:
``<package>_VERSION`` ``<PackageName>_VERSION``
full provided version string full provided version string
``<package>_VERSION_MAJOR`` ``<PackageName>_VERSION_MAJOR``
major version if provided, else 0 major version if provided, else 0
``<package>_VERSION_MINOR`` ``<PackageName>_VERSION_MINOR``
minor version if provided, else 0 minor version if provided, else 0
``<package>_VERSION_PATCH`` ``<PackageName>_VERSION_PATCH``
patch version if provided, else 0 patch version if provided, else 0
``<package>_VERSION_TWEAK`` ``<PackageName>_VERSION_TWEAK``
tweak version if provided, else 0 tweak version if provided, else 0
``<package>_VERSION_COUNT`` ``<PackageName>_VERSION_COUNT``
number of version components, 0 to 4 number of version components, 0 to 4
and the corresponding package configuration file is loaded. and the corresponding package configuration file is loaded.
...@@ -192,7 +192,7 @@ Much of the interface is provided for completeness and for use ...@@ -192,7 +192,7 @@ Much of the interface is provided for completeness and for use
internally by find-modules loaded by Module mode. Most user code internally by find-modules loaded by Module mode. Most user code
should simply call:: should simply call::
find_package(<package> [major[.minor]] [EXACT] [REQUIRED|QUIET]) find_package(<PackageName> [major[.minor]] [EXACT] [REQUIRED|QUIET])
in order to find a package. Package maintainers providing CMake in order to find a package. Package maintainers providing CMake
package configuration files are encouraged to name and install them package configuration files are encouraged to name and install them
...@@ -228,7 +228,7 @@ containing a configuration file:: ...@@ -228,7 +228,7 @@ containing a configuration file::
<prefix>/<name>.app/Contents/Resources/CMake/ (A) <prefix>/<name>.app/Contents/Resources/CMake/ (A)
In all cases the ``<name>`` is treated as case-insensitive and corresponds In all cases the ``<name>`` is treated as case-insensitive and corresponds
to any of the names specified (``<package>`` or names given by ``NAMES``). to any of the names specified (``<PackageName>`` or names given by ``NAMES``).
Paths with ``lib/<arch>`` are enabled if the Paths with ``lib/<arch>`` are enabled if the
:variable:`CMAKE_LIBRARY_ARCHITECTURE` variable is set. ``lib*`` includes one :variable:`CMAKE_LIBRARY_ARCHITECTURE` variable is set. ``lib*`` includes one
...@@ -286,7 +286,7 @@ enabled. ...@@ -286,7 +286,7 @@ enabled.
(``;`` on Windows and ``:`` on UNIX). (``;`` on Windows and ``:`` on UNIX).
This can be skipped if ``NO_CMAKE_ENVIRONMENT_PATH`` is passed:: This can be skipped if ``NO_CMAKE_ENVIRONMENT_PATH`` is passed::
<package>_DIR <PackageName>_DIR
CMAKE_PREFIX_PATH CMAKE_PREFIX_PATH
CMAKE_FRAMEWORK_PATH CMAKE_FRAMEWORK_PATH
CMAKE_APPBUNDLE_PATH CMAKE_APPBUNDLE_PATH
...@@ -329,7 +329,7 @@ enabled. ...@@ -329,7 +329,7 @@ enabled.
hard-coded guesses. hard-coded guesses.
.. |FIND_XXX| replace:: find_package .. |FIND_XXX| replace:: find_package
.. |FIND_ARGS_XXX| replace:: <package> .. |FIND_ARGS_XXX| replace:: <PackageName>
.. |CMAKE_FIND_ROOT_PATH_MODE_XXX| replace:: .. |CMAKE_FIND_ROOT_PATH_MODE_XXX| replace::
:variable:`CMAKE_FIND_ROOT_PATH_MODE_PACKAGE` :variable:`CMAKE_FIND_ROOT_PATH_MODE_PACKAGE`
...@@ -344,28 +344,28 @@ defines variables to provide information about the call arguments (and ...@@ -344,28 +344,28 @@ defines variables to provide information about the call arguments (and
restores their original state before returning): restores their original state before returning):
``CMAKE_FIND_PACKAGE_NAME`` ``CMAKE_FIND_PACKAGE_NAME``
the ``<package>`` name which is searched for the ``<PackageName>`` which is searched for
``<package>_FIND_REQUIRED`` ``<PackageName>_FIND_REQUIRED``
true if ``REQUIRED`` option was given true if ``REQUIRED`` option was given
``<package>_FIND_QUIETLY`` ``<PackageName>_FIND_QUIETLY``
true if ``QUIET`` option was given true if ``QUIET`` option was given
``<package>_FIND_VERSION`` ``<PackageName>_FIND_VERSION``
full requested version string full requested version string
``<package>_FIND_VERSION_MAJOR`` ``<PackageName>_FIND_VERSION_MAJOR``
major version if requested, else 0 major version if requested, else 0
``<package>_FIND_VERSION_MINOR`` ``<PackageName>_FIND_VERSION_MINOR``
minor version if requested, else 0 minor version if requested, else 0
``<package>_FIND_VERSION_PATCH`` ``<PackageName>_FIND_VERSION_PATCH``
patch version if requested, else 0 patch version if requested, else 0
``<package>_FIND_VERSION_TWEAK`` ``<PackageName>_FIND_VERSION_TWEAK``
tweak version if requested, else 0 tweak version if requested, else 0
``<package>_FIND_VERSION_COUNT`` ``<PackageName>_FIND_VERSION_COUNT``
number of version components, 0 to 4 number of version components, 0 to 4
``<package>_FIND_VERSION_EXACT`` ``<PackageName>_FIND_VERSION_EXACT``
true if ``EXACT`` option was given true if ``EXACT`` option was given
``<package>_FIND_COMPONENTS`` ``<PackageName>_FIND_COMPONENTS``
list of requested components list of requested components
``<package>_FIND_REQUIRED_<c>`` ``<PackageName>_FIND_REQUIRED_<c>``
true if component ``<c>`` is required, true if component ``<c>`` is required,
false if component ``<c>`` is optional false if component ``<c>`` is optional
...@@ -375,7 +375,7 @@ In Config mode ``find_package`` handles ``REQUIRED``, ``QUIET``, and ...@@ -375,7 +375,7 @@ In Config mode ``find_package`` handles ``REQUIRED``, ``QUIET``, and
``[version]`` options automatically but leaves it to the package ``[version]`` options automatically but leaves it to the package
configuration file to handle components in a way that makes sense configuration file to handle components in a way that makes sense
for the package. The package configuration file may set for the package. The package configuration file may set
``<package>_FOUND`` to false to tell ``find_package`` that component ``<PackageName>_FOUND`` to false to tell ``find_package`` that component
requirements are not satisfied. requirements are not satisfied.
See the :command:`cmake_policy` command documentation for discussion See the :command:`cmake_policy` command documentation for discussion
......
...@@ -214,8 +214,8 @@ Windows using WiX. ...@@ -214,8 +214,8 @@ Windows using WiX.
If this variable is set the generated installer will create If this variable is set the generated installer will create
an entry in the windows registry key an entry in the windows registry key
``HKEY_LOCAL_MACHINE\Software\Kitware\CMake\Packages\<package>`` ``HKEY_LOCAL_MACHINE\Software\Kitware\CMake\Packages\<PackageName>``
The value for ``<package>`` is provided by this variable. The value for ``<PackageName>`` is provided by this variable.
Assuming you also install a CMake configuration file this will Assuming you also install a CMake configuration file this will
allow other CMake projects to find your package with allow other CMake projects to find your package with
......
...@@ -579,11 +579,11 @@ file and the ``Help/manual/cmake-modules.7.rst`` toctree entry. ...@@ -579,11 +579,11 @@ file and the ``Help/manual/cmake-modules.7.rst`` toctree entry.
Find Modules Find Modules
------------ ------------
A "find module" is a ``Modules/Find<package>.cmake`` file to be loaded A "find module" is a ``Modules/Find<PackageName>.cmake`` file to be loaded
by the :command:`find_package` command when invoked for ``<package>``. by the :command:`find_package` command when invoked for ``<PackageName>``.
The primary task of a find module is to determine whether a package The primary task of a find module is to determine whether a package
exists on the system, set the ``<package>_FOUND`` variable to reflect exists on the system, set the ``<PackageName>_FOUND`` variable to reflect
this and provide any variables, macros and imported targets required to this and provide any variables, macros and imported targets required to
use the package. A find module is useful in cases where an upstream use the package. A find module is useful in cases where an upstream
library does not provide a library does not provide a
......
...@@ -73,7 +73,7 @@ Handling of ``COMPONENTS`` and ``OPTIONAL_COMPONENTS`` is defined by the ...@@ -73,7 +73,7 @@ Handling of ``COMPONENTS`` and ``OPTIONAL_COMPONENTS`` is defined by the
package. package.
By setting the :variable:`CMAKE_DISABLE_FIND_PACKAGE_<PackageName>` variable to By setting the :variable:`CMAKE_DISABLE_FIND_PACKAGE_<PackageName>` variable to
``TRUE``, the ``PackageName`` package will not be searched, and will always ``TRUE``, the ``<PackageName>`` package will not be searched, and will always
be ``NOTFOUND``. be ``NOTFOUND``.
.. _`Config File Packages`: .. _`Config File Packages`:
...@@ -92,9 +92,9 @@ packages, that is, they belong with the header files and any other files ...@@ -92,9 +92,9 @@ packages, that is, they belong with the header files and any other files
provided to assist downstreams in using the package. provided to assist downstreams in using the package.
A set of variables which provide package status information are also set A set of variables which provide package status information are also set
automatically when using a config-file package. The ``<Package>_FOUND`` automatically when using a config-file package. The ``<PackageName>_FOUND``
variable is set to true or false, depending on whether the package was variable is set to true or false, depending on whether the package was
found. The ``<Package>_DIR`` cache variable is set to the location of the found. The ``<PackageName>_DIR`` cache variable is set to the location of the
package configuration file. package configuration file.
Find-module Packages Find-module Packages
...@@ -108,10 +108,10 @@ file, it is not shipped with upstream, but is used by downstream to find the ...@@ -108,10 +108,10 @@ file, it is not shipped with upstream, but is used by downstream to find the
files by guessing locations of files with platform-specific hints. files by guessing locations of files with platform-specific hints.
Unlike the case of an upstream-provided package configuration file, no single point Unlike the case of an upstream-provided package configuration file, no single point
of reference identifies the package as being found, so the ``<Package>_FOUND`` of reference identifies the package as being found, so the ``<PackageName>_FOUND``
variable is not automatically set by the :command:`find_package` command. It variable is not automatically set by the :command:`find_package` command. It
can still be expected to be set by convention however and should be set by can still be expected to be set by convention however and should be set by
the author of the Find-module. Similarly there is no ``<Package>_DIR`` variable, the author of the Find-module. Similarly there is no ``<PackageName>_DIR`` variable,
but each of the artifacts such as library locations and header file locations but each of the artifacts such as library locations and header file locations
provide a separate cache variable. provide a separate cache variable.
...@@ -197,7 +197,7 @@ When the :command:`find_package` command loads a version file it first sets the ...@@ -197,7 +197,7 @@ When the :command:`find_package` command loads a version file it first sets the
following variables: following variables:
``PACKAGE_FIND_NAME`` ``PACKAGE_FIND_NAME``
The <package> name The ``<PackageName>``
``PACKAGE_FIND_VERSION`` ``PACKAGE_FIND_VERSION``
Full requested version string Full requested version string
...@@ -240,26 +240,26 @@ variables. When the version file claims to be an acceptable match for the ...@@ -240,26 +240,26 @@ variables. When the version file claims to be an acceptable match for the
requested version the find_package command sets the following variables for requested version the find_package command sets the following variables for
use by the project: use by the project:
``<package>_VERSION`` ``<PackageName>_VERSION``
Full provided version string Full provided version string
``<package>_VERSION_MAJOR`` ``<PackageName>_VERSION_MAJOR``
Major version if provided, else 0 Major version if provided, else 0
``<package>_VERSION_MINOR`` ``<PackageName>_VERSION_MINOR``
Minor version if provided, else 0 Minor version if provided, else 0
``<package>_VERSION_PATCH`` ``<PackageName>_VERSION_PATCH``
Patch version if provided, else 0 Patch version if provided, else 0
``<package>_VERSION_TWEAK`` ``<PackageName>_VERSION_TWEAK``
Tweak version if provided, else 0 Tweak version if provided, else 0
``<package>_VERSION_COUNT`` ``<PackageName>_VERSION_COUNT``
Number of version components, 0 to 4 Number of version components, 0 to 4
The variables report the version of the package that was actually found. The variables report the version of the package that was actually found.
The ``<package>`` part of their name matches the argument given to the The ``<PackageName>`` part of their name matches the argument given to the
:command:`find_package` command. :command:`find_package` command.
.. _`Creating Packages`: .. _`Creating Packages`:
...@@ -347,8 +347,8 @@ The :module:`CMakePackageConfigHelpers` module provides a macro for creating ...@@ -347,8 +347,8 @@ The :module:`CMakePackageConfigHelpers` module provides a macro for creating
a simple ``ConfigVersion.cmake`` file. This file sets the version of the a simple ``ConfigVersion.cmake`` file. This file sets the version of the
package. It is read by CMake when :command:`find_package` is called to package. It is read by CMake when :command:`find_package` is called to
determine the compatibility with the requested version, and to set some determine the compatibility with the requested version, and to set some
version-specific variables ``<Package>_VERSION``, ``<Package>_VERSION_MAJOR``, version-specific variables ``<PackageName>_VERSION``, ``<PackageName>_VERSION_MAJOR``,
``<Package>_VERSION_MINOR`` etc. The :command:`install(EXPORT)` command is ``<PackageName>_VERSION_MINOR`` etc. The :command:`install(EXPORT)` command is
used to export the targets in the ``ClimbingStatsTargets`` export-set, defined used to export the targets in the ``ClimbingStatsTargets`` export-set, defined
previously by the :command:`install(TARGETS)` command. This command generates previously by the :command:`install(TARGETS)` command. This command generates
the ``ClimbingStatsTargets.cmake`` file to contain :prop_tgt:`IMPORTED` the ``ClimbingStatsTargets.cmake`` file to contain :prop_tgt:`IMPORTED`
...@@ -432,8 +432,8 @@ the dependency is not found, along with a diagnostic that the ``ClimbingStats`` ...@@ -432,8 +432,8 @@ the dependency is not found, along with a diagnostic that the ``ClimbingStats``
package can not be used without the ``Stats`` package. package can not be used without the ``Stats`` package.
If ``COMPONENTS`` are specified when the downstream uses :command:`find_package`, If ``COMPONENTS`` are specified when the downstream uses :command:`find_package`,
they are listed in the ``<Package>_FIND_COMPONENTS`` variable. If a particular they are listed in the ``<PackageName>_FIND_COMPONENTS`` variable. If a particular
component is non-optional, then the ``<Package>_FIND_REQUIRED_<comp>`` will component is non-optional, then the ``<PackageName>_FIND_REQUIRED_<comp>`` will
be true. This can be tested with logic in the package configuration file: be true. This can be tested with logic in the package configuration file:
.. code-block:: cmake .. code-block:: cmake
...@@ -580,8 +580,8 @@ non-standard install locations or directly in their own build trees. ...@@ -580,8 +580,8 @@ non-standard install locations or directly in their own build trees.
A project may populate either the user or system registry (using its own A project may populate either the user or system registry (using its own
means, see below) to refer to its location. means, see below) to refer to its location.
In either case the package should store at the registered location a In either case the package should store at the registered location a
`Package Configuration File`_ (``<package>Config.cmake``) and optionally a `Package Configuration File`_ (``<PackageName>Config.cmake``) and optionally a
`Package Version File`_ (``<package>ConfigVersion.cmake``). `Package Version File`_ (``<PackageName>ConfigVersion.cmake``).
The :command:`find_package` command searches the two package registries The :command:`find_package` command searches the two package registries
as two of the search steps specified in its documentation. If it has as two of the search steps specified in its documentation. If it has
...@@ -603,18 +603,18 @@ must be manually taught to register their packages if desired. ...@@ -603,18 +603,18 @@ must be manually taught to register their packages if desired.
On Windows the user package registry is stored in the Windows registry On Windows the user package registry is stored in the Windows registry
under a key in ``HKEY_CURRENT_USER``. under a key in ``HKEY_CURRENT_USER``.
A ``<package>`` may appear under registry key:: A ``<PackageName>`` may appear under registry key::
HKEY_CURRENT_USER\Software\Kitware\CMake\Packages\<package> HKEY_CURRENT_USER\Software\Kitware\CMake\Packages\<PackageName>
as a ``REG_SZ`` value, with arbitrary name, that specifies the directory as a ``REG_SZ`` value, with arbitrary name, that specifies the directory
containing the package configuration file. containing the package configuration file.
On UNIX platforms the user package registry is stored in the user home On UNIX platforms the user package registry is stored in the user home
directory under ``~/.cmake/packages``. A ``<package>`` may appear under directory under ``~/.cmake/packages``. A ``<PackageName>`` may appear under
the directory:: the directory::
~/.cmake/packages/<package> ~/.cmake/packages/<PackageName>
as a file, with arbitrary name, whose content specifies the directory as a file, with arbitrary name, whose content specifies the directory
containing the package configuration file. containing the package configuration file.
...@@ -629,10 +629,10 @@ CMake currently provides no interface to add to the system package registry. ...@@ -629,10 +629,10 @@ CMake currently provides no interface to add to the system package registry.
Installers must be manually taught to register their packages if desired. Installers must be manually taught to register their packages if desired.
On Windows the system package registry is stored in the Windows registry On Windows the system package registry is stored in the Windows registry
under a key in ``HKEY_LOCAL_MACHINE``. A ``<package>`` may appear under under a key in ``HKEY_LOCAL_MACHINE``. A ``<PackageName>`` may appear under
registry key:: registry key::
HKEY_LOCAL_MACHINE\Software\Kitware\CMake\Packages\<package> HKEY_LOCAL_MACHINE\Software\Kitware\CMake\Packages\<PackageName>
as a ``REG_SZ`` value, with arbitrary name, that specifies the directory as a ``REG_SZ`` value, with arbitrary name, that specifies the directory
containing the package configuration file. containing the package configuration file.
......
...@@ -14,7 +14,7 @@ CMakeFindDependencyMacro ...@@ -14,7 +14,7 @@ CMakeFindDependencyMacro
It is designed to be used in a It is designed to be used in a
:ref:`Package Configuration File <Config File Packages>` :ref:`Package Configuration File <Config File Packages>`
(``<package>Config.cmake``). ``find_dependency`` forwards the correct (``<PackageName>Config.cmake``). ``find_dependency`` forwards the correct
parameters for ``QUIET`` and ``REQUIRED`` which were passed to parameters for ``QUIET`` and ``REQUIRED`` which were passed to
the original :command:`find_package` call. Any additional arguments the original :command:`find_package` call. Any additional arguments
specified are forwarded to :command:`find_package`. specified are forwarded to :command:`find_package`.
......
...@@ -27,10 +27,10 @@ ...@@ -27,10 +27,10 @@
# ) # )
# #
# ``configure_package_config_file()`` should be used instead of the plain # ``configure_package_config_file()`` should be used instead of the plain
# :command:`configure_file()` command when creating the ``<Name>Config.cmake`` # :command:`configure_file()` command when creating the ``<PackageName>Config.cmake``
# or ``<Name>-config.cmake`` file for installing a project or library. It helps # or ``<PackageName>-config.cmake`` file for installing a project or library.
# making the resulting package relocatable by avoiding hardcoded paths in the # It helps making the resulting package relocatable by avoiding hardcoded paths
# installed ``Config.cmake`` file. # in the installed ``Config.cmake`` file.
# #
# In a ``FooConfig.cmake`` file there may be code like this to make the install # In a ``FooConfig.cmake`` file there may be code like this to make the install
# destinations know to the using project: # destinations know to the using project:
...@@ -101,7 +101,7 @@ ...@@ -101,7 +101,7 @@
# When using the ``NO_SET_AND_CHECK_MACRO``, this macro is not generated # When using the ``NO_SET_AND_CHECK_MACRO``, this macro is not generated
# into the ``FooConfig.cmake`` file. # into the ``FooConfig.cmake`` file.
# #
# ``check_required_components(<package_name>)`` should be called at the end of # ``check_required_components(<PackageName>)`` should be called at the end of
# the ``FooConfig.cmake`` file. This macro checks whether all requested, # the ``FooConfig.cmake`` file. This macro checks whether all requested,
# non-optional components have been found, and if this is not the case, sets # non-optional components have been found, and if this is not the case, sets
# the ``Foo_FOUND`` variable to ``FALSE``, so that the package is considered to # the ``Foo_FOUND`` variable to ``FALSE``, so that the package is considered to
...@@ -127,7 +127,7 @@ ...@@ -127,7 +127,7 @@
# COMPATIBILITY <AnyNewerVersion|SameMajorVersion|SameMinorVersion|ExactVersion> ) # COMPATIBILITY <AnyNewerVersion|SameMajorVersion|SameMinorVersion|ExactVersion> )
# #
# #
# Writes a file for use as ``<package>ConfigVersion.cmake`` file to # Writes a file for use as ``<PackageName>ConfigVersion.cmake`` file to
# ``<filename>``. See the documentation of :command:`find_package()` for # ``<filename>``. See the documentation of :command:`find_package()` for
# details on this. # details on this.
# #
......
...@@ -145,7 +145,7 @@ endmacro() ...@@ -145,7 +145,7 @@ endmacro()
# internal helper macro to generate the failure message when used in CONFIG_MODE: # internal helper macro to generate the failure message when used in CONFIG_MODE:
macro(_FPHSA_HANDLE_FAILURE_CONFIG_MODE) macro(_FPHSA_HANDLE_FAILURE_CONFIG_MODE)
# <name>_CONFIG is set, but FOUND is false, this means that some other of the REQUIRED_VARS was not found: # <PackageName>_CONFIG is set, but FOUND is false, this means that some other of the REQUIRED_VARS was not found:
if(${_NAME}_CONFIG) if(${_NAME}_CONFIG)
_FPHSA_FAILURE_MESSAGE("${FPHSA_FAIL_MESSAGE}: missing:${MISSING_VARS} (found ${${_NAME}_CONFIG} ${VERSION_MSG})") _FPHSA_FAILURE_MESSAGE("${FPHSA_FAIL_MESSAGE}: missing:${MISSING_VARS} (found ${${_NAME}_CONFIG} ${VERSION_MSG})")
else() else()
...@@ -199,7 +199,7 @@ function(FIND_PACKAGE_HANDLE_STANDARD_ARGS _NAME _FIRST_ARG) ...@@ -199,7 +199,7 @@ function(FIND_PACKAGE_HANDLE_STANDARD_ARGS _NAME _FIRST_ARG)
set(FPHSA_FAIL_MESSAGE "DEFAULT_MSG") set(FPHSA_FAIL_MESSAGE "DEFAULT_MSG")
endif() endif()
# In config-mode, we rely on the variable <package>_CONFIG, which is set by find_package() # In config-mode, we rely on the variable <PackageName>_CONFIG, which is set by find_package()
# when it successfully found the config-file, including version checking: # when it successfully found the config-file, including version checking:
if(FPHSA_CONFIG_MODE) if(FPHSA_CONFIG_MODE)
list(INSERT FPHSA_REQUIRED_VARS 0 ${_NAME}_CONFIG) list(INSERT FPHSA_REQUIRED_VARS 0 ${_NAME}_CONFIG)
......
...@@ -487,7 +487,7 @@ bool cmFindPackageCommand::InitialPass(std::vector<std::string> const& args, ...@@ -487,7 +487,7 @@ bool cmFindPackageCommand::InitialPass(std::vector<std::string> const& args,
this->SetModuleVariables(components); this->SetModuleVariables(components);
// See if there is a Find<package>.cmake module. // See if there is a Find<PackageName>.cmake module.
if (this->UseFindModules) { if (this->UseFindModules) {
bool foundModule = false; bool foundModule = false;
if (!this->FindModule(foundModule)) { if (!this->FindModule(foundModule)) {
...@@ -538,7 +538,7 @@ bool cmFindPackageCommand::InitialPass(std::vector<std::string> const& args, ...@@ -538,7 +538,7 @@ bool cmFindPackageCommand::InitialPass(std::vector<std::string> const& args,
} }
// No find module. Assume the project has a CMake config file. Use // No find module. Assume the project has a CMake config file. Use
// a <package>_DIR cache variable to locate it. // a <PackageName>_DIR cache variable to locate it.
this->Variable = this->Name; this->Variable = this->Name;
this->Variable += "_DIR"; this->Variable += "_DIR";
......
...@@ -188,7 +188,7 @@ find_package(ArchC 3.1 EXACT NAMES zot) ...@@ -188,7 +188,7 @@ find_package(ArchC 3.1 EXACT NAMES zot)
find_package(ArchD 4.0 EXACT NAMES zot) find_package(ArchD 4.0 EXACT NAMES zot)
unset(CMAKE_LIBRARY_ARCHITECTURE) unset(CMAKE_LIBRARY_ARCHITECTURE)
# Test <Package>_DIR environment variable. # Test <PackageName>_DIR environment variable.
# We erase the main prefix path to ensure the env var is used. # We erase the main prefix path to ensure the env var is used.
set(CMAKE_PREFIX_PATH) set(CMAKE_PREFIX_PATH)
set(ENV{EnvA_DIR} "${CMAKE_CURRENT_SOURCE_DIR}/lib/zot-3.1") set(ENV{EnvA_DIR} "${CMAKE_CURRENT_SOURCE_DIR}/lib/zot-3.1")
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment