summaryrefslogtreecommitdiffstats
path: root/Help/command/find_package.rst
diff options
context:
space:
mode:
authorCraig Scott <craig.scott@crascit.com>2022-06-06 10:52:31 (GMT)
committerCraig Scott <craig.scott@crascit.com>2022-06-09 12:55:11 (GMT)
commit92e93f5c9e309d0e2f9c119e9aa9bbff477602e2 (patch)
treeab790ef749ec13cb88ce90543eca6b765172128c /Help/command/find_package.rst
parent007181a16584c02419d77b7fd258b170ed9ea2fa (diff)
downloadCMake-92e93f5c9e309d0e2f9c119e9aa9bbff477602e2.zip
CMake-92e93f5c9e309d0e2f9c119e9aa9bbff477602e2.tar.gz
CMake-92e93f5c9e309d0e2f9c119e9aa9bbff477602e2.tar.bz2
Help: Overhaul and expand the Using Dependencies Guide
The guide previously only focused on the find_package() command, with a bias towards libraries. FetchContent was not mentioned at all. Reorganise and update the existing content. Add new sections to cover providing dependencies with FetchContent and dependency providers. Improve discoverability of the guide by mentioning it at the beginning of the find_package(), FetchContent and dependency provider docs.
Diffstat (limited to 'Help/command/find_package.rst')
-rw-r--r--Help/command/find_package.rst6
1 files changed, 6 insertions, 0 deletions
diff --git a/Help/command/find_package.rst b/Help/command/find_package.rst
index a4dad21..2a924af 100644
--- a/Help/command/find_package.rst
+++ b/Help/command/find_package.rst
@@ -11,6 +11,12 @@ find_package
.. contents::
+.. note:: The :guide:`Using Dependencies Guide` provides a high-level
+ introduction to this general topic. It provides a broader overview of
+ where the ``find_package()`` command fits into the bigger picture,
+ including its relationship to the :module:`FetchContent` module.
+ The guide is recommended pre-reading before moving on to the details below.
+
Find a package (usually provided by something external to the project),
and load its package-specific details. Calls to this command can also
be intercepted by :ref:`dependency providers <dependency_providers>`.