From 169f116632321e99701986f48a19e836d2b9e710 Mon Sep 17 00:00:00 2001 From: Stephen Kelly Date: Thu, 4 Dec 2014 23:19:45 +0100 Subject: [PATCH] Help: Link to cmake-packages(7) from the Module creation documentation. --- Help/manual/cmake-developer.7.rst | 4 +++- Help/manual/cmake-packages.7.rst | 2 ++ 2 files changed, 5 insertions(+), 1 deletion(-) diff --git a/Help/manual/cmake-developer.7.rst b/Help/manual/cmake-developer.7.rst index 672c9b7e1..c7bafc0be 100644 --- a/Help/manual/cmake-developer.7.rst +++ b/Help/manual/cmake-developer.7.rst @@ -720,7 +720,9 @@ by the :command:`find_package` command when invoked for ````. The primary task of a find module is to determine whether a package exists on the system, set the ``_FOUND`` variable to reflect this and provide any variables, macros and imported targets required to -use the package. +use the package. A find module is useful in cases where an upstream +library does not provide a +:ref:`config file package `. The traditional approach is to use variables for everything, including libraries and executables: see the `Standard Variable Names`_ section diff --git a/Help/manual/cmake-packages.7.rst b/Help/manual/cmake-packages.7.rst index 0d18fd7f8..fba1d61ec 100644 --- a/Help/manual/cmake-packages.7.rst +++ b/Help/manual/cmake-packages.7.rst @@ -76,6 +76,8 @@ By setting the :variable:`CMAKE_DISABLE_FIND_PACKAGE_` variable to ``TRUE``, the ``PackageName`` package will not be searched, and will always be ``NOTFOUND``. +.. _`Config File Packages`: + Config-file Packages --------------------