diff options
| author | Craig Scott <craig.scott@crascit.com> | 2019-10-27 05:10:09 (GMT) |
|---|---|---|
| committer | Craig Scott <craig.scott@crascit.com> | 2019-10-27 05:10:09 (GMT) |
| commit | 049dbdd38c56ad9ea06af2032faf3348c3c76742 (patch) | |
| tree | e6284df653308f3af4330bdf8de61910c05ff072 /Help/policy | |
| parent | 92780281c2e8a46223b262b152caa9c8329373b1 (diff) | |
| download | CMake-049dbdd38c56ad9ea06af2032faf3348c3c76742.zip CMake-049dbdd38c56ad9ea06af2032faf3348c3c76742.tar.gz CMake-049dbdd38c56ad9ea06af2032faf3348c3c76742.tar.bz2 | |
Help: Document that <PackageName>_ROOT applies to config packages too
The original intent of <PackageName>_ROOT may have been for it
to apply only to Find modules, but the implementation of the
find_package() command treats modules and config packages the
same. Both result in a <PackageName>_ROOT variable being
pushed onto the stack of package roots. A config package can
also call other find_...() commands, the behavior doesn't apply
just to find modules.
Diffstat (limited to 'Help/policy')
| -rw-r--r-- | Help/policy/CMP0074.rst | 6 |
1 files changed, 3 insertions, 3 deletions
diff --git a/Help/policy/CMP0074.rst b/Help/policy/CMP0074.rst index 896936b..63ebf7b 100644 --- a/Help/policy/CMP0074.rst +++ b/Help/policy/CMP0074.rst @@ -7,9 +7,9 @@ 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. +commands inside find modules and config packages 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. The ``OLD`` behavior for this policy is to ignore ``<PackageName>_ROOT`` variables. The ``NEW`` behavior for this policy is to use |