summaryrefslogtreecommitdiff
path: root/share/cmake-3.17/Help/variable/PackageName_ROOT.rst
diff options
context:
space:
mode:
Diffstat (limited to 'share/cmake-3.17/Help/variable/PackageName_ROOT.rst')
-rw-r--r--share/cmake-3.17/Help/variable/PackageName_ROOT.rst14
1 files changed, 14 insertions, 0 deletions
diff --git a/share/cmake-3.17/Help/variable/PackageName_ROOT.rst b/share/cmake-3.17/Help/variable/PackageName_ROOT.rst
new file mode 100644
index 0000000..1c2fd34
--- /dev/null
+++ b/share/cmake-3.17/Help/variable/PackageName_ROOT.rst
@@ -0,0 +1,14 @@
+<PackageName>_ROOT
+------------------
+
+Calls to :command:`find_package(<PackageName>)` will search in prefixes
+specified by the ``<PackageName>_ROOT`` CMake variable, where
+``<PackageName>`` is the name given to the :command:`find_package` call
+and ``_ROOT`` is literal. For example, ``find_package(Foo)`` will search
+prefixes specified in the ``Foo_ROOT`` CMake variable (if set).
+See policy :policy:`CMP0074`.
+
+This variable may hold a single prefix or a
+:ref:`semicolon-separated list <CMake Language Lists>` of multiple prefixes.
+
+See also the :envvar:`<PackageName>_ROOT` environment variable.