Browse Source

Help: Add internal section link to find_package command docs

Joachim Wuttke (l) 7 years ago
parent
commit
11058a2e7c
1 changed files with 8 additions and 6 deletions
  1. 8 6
      Help/command/find_package.rst

+ 8 - 6
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