summaryrefslogtreecommitdiffstats
path: root/Help/command/find_package.rst
diff options
context:
space:
mode:
authorJoachim Wuttke (l) <j.wuttke@fz-juelich.de>2018-10-04 07:53:50 (GMT)
committerBrad King <brad.king@kitware.com>2018-10-04 20:42:42 (GMT)
commit11058a2e7cd3e673cc72d0f5bb1b214b4ecb4ad3 (patch)
tree6b6347ff3db9bfb39e8b3c43b22292bdf7644590 /Help/command/find_package.rst
parentaaf5ea2d7034eb42659e985ae5bd51dde3625134 (diff)
downloadCMake-11058a2e7cd3e673cc72d0f5bb1b214b4ecb4ad3.zip
CMake-11058a2e7cd3e673cc72d0f5bb1b214b4ecb4ad3.tar.gz
CMake-11058a2e7cd3e673cc72d0f5bb1b214b4ecb4ad3.tar.bz2
Help: Add internal section link to find_package command docs
Diffstat (limited to 'Help/command/find_package.rst')
-rw-r--r--Help/command/find_package.rst14
1 files changed, 8 insertions, 6 deletions
diff --git a/Help/command/find_package.rst b/Help/command/find_package.rst
index d54b514..1db386b 100644
--- a/Help/command/find_package.rst
+++ b/Help/command/find_package.rst
@@ -7,6 +7,8 @@ find_package
Find an external project, and load its settings.
+.. _`basic signature`:
+
Basic Signature and Module Mode
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
@@ -40,7 +42,7 @@ should be compatible (format is ``major[.minor[.patch[.tweak]]]``). The
inside a find-module, the corresponding arguments are forwarded
automatically from the outer call (including the ``EXACT`` flag for
``[version]``). Version support is currently provided only on a
-package-by-package basis (details below).
+package-by-package basis (see the `Version Selection`_ section below).
See the :command:`cmake_policy` command documentation for discussion
of the ``NO_POLICY_SCOPE`` option.
@@ -48,15 +50,15 @@ of the ``NO_POLICY_SCOPE`` option.
Full Signature and Config Mode
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-User code should generally look for packages using the above simple
-signature. The remainder of this command documentation specifies the
+User code should generally look for packages using the above `basic
+signature`_. The remainder of this command documentation specifies the
full command signature and details of the search process. Project
maintainers wishing to provide a package to be found by this command
are encouraged to read on.
The command has two modes by which it searches for packages: "Module"
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 `basic signature`_. CMake searches for a file
called ``Find<PackageName>.cmake`` in the :variable:`CMAKE_MODULE_PATH`
followed by the CMake installation. If the file is found, it is read
and processed by CMake. It is responsible for finding the package,
@@ -91,8 +93,8 @@ The complete Config mode command signature is::
The ``CONFIG`` option may be used to skip Module mode explicitly and
switch to Config mode. It is synonymous to using ``NO_MODULE``. Config
-mode is also implied by use of options not specified in the reduced
-signature.
+mode is also implied by use of options not specified in the `basic
+signature`_.
Config mode attempts to locate a configuration file provided by the
package to be found. A cache entry called ``<PackageName>_DIR`` is created to