33856b1d62
Extend commit 1a35351125 (Add CMAKE_POLICY_VERSION_MINIMUM to help
configure outdated projects, 2025-02-13, v4.0.0-rc1~12^2) with an
environment variable to initialize the cache entry. That will make it
easier to use when `cmake` is invoked under layers of scripting.
Closes: #26715
28 lines
1.2 KiB
ReStructuredText
28 lines
1.2 KiB
ReStructuredText
CMAKE_POLICY_VERSION_MINIMUM
|
|
----------------------------
|
|
|
|
.. versionadded:: 4.0
|
|
|
|
Specify a minimum :ref:`Policy Version` for a project without modifying
|
|
its calls to :command:`cmake_minimum_required(VERSION)` and
|
|
:command:`cmake_policy(VERSION)`.
|
|
|
|
This variable should not be set by a project in CMake code as a way to
|
|
set its own policy version. Use :command:`cmake_minimum_required(VERSION)`
|
|
and/or :command:`cmake_policy(VERSION)` for that. This variable is meant
|
|
to externally set policies for which a project has not itself been updated:
|
|
|
|
* Users running CMake may set this variable in the cache, e.g.,
|
|
``-DCMAKE_POLICY_VERSION_MINIMUM=3.5``, to try configuring a project
|
|
that has not been updated to set at least that policy version itself.
|
|
|
|
Alternatively, users may set the :envvar:`CMAKE_POLICY_VERSION_MINIMUM`
|
|
environment variable to initialize the cache entry in new build trees
|
|
automatically.
|
|
|
|
* Projects may set this variable before a call to :command:`add_subdirectory`
|
|
that adds a third-party project in order to set its policy version without
|
|
modifying third-party code.
|
|
|
|
See :variable:`CMAKE_POLICY_DEFAULT_CMP<NNNN>` to set individual policies.
|