mirror of
https://github.com/Kitware/CMake.git
synced 2026-01-05 21:31:08 -06:00
ad3c2c0b03
Every policy's documentation has a paragraph on what version of CMake introduced it, how to set the policy, and whether CMake warns if the policy is not set. The wording of this paragraph has diverged across policies over time. Factor the paragraph out into a standard advice document included by every policy.
26 lines
1015 B
ReStructuredText
26 lines
1015 B
ReStructuredText
CMP0144
|
|
-------
|
|
|
|
.. versionadded:: 3.27
|
|
|
|
:command:`find_package` uses upper-case ``<PACKAGENAME>_ROOT`` variables.
|
|
|
|
In CMake 3.27 and above the :command:`find_package(<PackageName>)` command now
|
|
searches prefixes specified by the upper-case :variable:`<PACKAGENAME>_ROOT`
|
|
CMake variable and the :envvar:`<PACKAGENAME>_ROOT` environment variable
|
|
in addition to the case-preserved :variable:`<PackageName>_ROOT` and
|
|
:envvar:`<PackageName>_ROOT` variables used since policy :policy:`CMP0074`.
|
|
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 if the original ``<PackageName>`` has lower-case characters.
|
|
The ``NEW`` behavior for this policy is to use ``<PACKAGENAME>_ROOT``
|
|
variables.
|
|
|
|
.. |INTRODUCED_IN_CMAKE_VERSION| replace:: 3.27
|
|
.. |WARNS_OR_DOES_NOT_WARN| replace:: warns
|
|
.. include:: STANDARD_ADVICE.txt
|
|
|
|
.. include:: DEPRECATED.txt
|