cmake/Help/variable/CMAKE_POLICY_DEFAULT_CMPNNNN.rst

25 lines
1.1 KiB
ReStructuredText
Raw Normal View History

2014-08-03 19:52:23 +02:00
CMAKE_POLICY_DEFAULT_CMP<NNNN>
------------------------------
2015-11-17 17:22:37 +01:00
Default for CMake Policy ``CMP<NNNN>`` when it is otherwise left unset.
2014-08-03 19:52:23 +02:00
2015-11-17 17:22:37 +01:00
Commands :command:`cmake_minimum_required(VERSION)` and
:command:`cmake_policy(VERSION)` by default leave policies introduced after
the given version unset. Set ``CMAKE_POLICY_DEFAULT_CMP<NNNN>`` to ``OLD``
or ``NEW`` to specify the default for policy ``CMP<NNNN>``, where ``<NNNN>``
is the policy number.
2014-08-03 19:52:23 +02:00
2021-12-08 00:18:10 +01:00
This variable should not be set by a project in CMake code as a way to
set its own policies; use :command:`cmake_policy(SET)` instead. 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_DEFAULT_CMP<NNNN>=<OLD|NEW>``). Set it to ``OLD``
to quiet a policy warning while using old behavior or to ``NEW`` to
try building the project with new behavior.
* Projects may set this variable before a call to :command:`add_subdirectory`
that adds a third-party project in order to set its policies without
modifying third-party code.