summaryrefslogtreecommitdiff
path: root/Help/policy
diff options
context:
space:
mode:
authorDongHun Kwak <dh0128.kwak@samsung.com>2021-10-08 09:13:26 +0900
committerDongHun Kwak <dh0128.kwak@samsung.com>2021-10-08 09:13:26 +0900
commite7ff50712c4a21dd73051147cb71225f63e05bcf (patch)
treeeaabc8bd601d045807d8548b1a22980fae568f59 /Help/policy
parente42c4abb646a39cdd5d1ccb22a9619990ce2a898 (diff)
downloadcmake-e7ff50712c4a21dd73051147cb71225f63e05bcf.tar.gz
cmake-e7ff50712c4a21dd73051147cb71225f63e05bcf.tar.bz2
cmake-e7ff50712c4a21dd73051147cb71225f63e05bcf.zip
Imported Upstream version 3.12.1upstream/3.12.1
Diffstat (limited to 'Help/policy')
-rw-r--r--Help/policy/CMP0074.rst15
1 files changed, 8 insertions, 7 deletions
diff --git a/Help/policy/CMP0074.rst b/Help/policy/CMP0074.rst
index ffac4a7cb..896936b21 100644
--- a/Help/policy/CMP0074.rst
+++ b/Help/policy/CMP0074.rst
@@ -1,18 +1,19 @@
CMP0074
-------
-:command:`find_package` uses ``PackageName_ROOT`` variables.
+:command:`find_package` uses ``<PackageName>_ROOT`` variables.
-In CMake 3.12 and above the ``find_package(PackageName)`` command now searches
-a prefix specified by a ``PackageName_ROOT`` CMake or environment variable.
+In CMake 3.12 and above the :command:`find_package(<PackageName>)` command now
+searches prefixes specified by the :variable:`<PackageName>_ROOT` CMake
+variable and the :envvar:`<PackageName>_ROOT` environment variable.
Package roots are maintained as a stack so nested calls to all ``find_*``
commands inside find modules also search the roots as prefixes. This policy
provides compatibility with projects that have not been updated to avoid using
-``PackageName_ROOT`` variables for other purposes.
+``<PackageName>_ROOT`` variables for other purposes.
-The ``OLD`` behavior for this policy is to ignore ``PackageName_ROOT``
-variables. The ``NEW`` behavior for this policy is to use ``PackageName_ROOT``
-variables.
+The ``OLD`` behavior for this policy is to ignore ``<PackageName>_ROOT``
+variables. The ``NEW`` behavior for this policy is to use
+``<PackageName>_ROOT`` variables.
This policy was introduced in CMake version 3.12. CMake version
|release| warns when the policy is not set and uses ``OLD`` behavior.