• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1CMAKE_POLICY_DEFAULT_CMP<NNNN>
2------------------------------
3
4Default for CMake Policy ``CMP<NNNN>`` when it is otherwise left unset.
5
6Commands :command:`cmake_minimum_required(VERSION)` and
7:command:`cmake_policy(VERSION)` by default leave policies introduced after
8the given version unset.  Set ``CMAKE_POLICY_DEFAULT_CMP<NNNN>`` to ``OLD``
9or ``NEW`` to specify the default for policy ``CMP<NNNN>``, where ``<NNNN>``
10is the policy number.
11
12This variable should not be set by a project in CMake code as a way to
13set its own policies; use :command:`cmake_policy(SET)` instead.  This
14variable is meant to externally set policies for which a project has
15not itself been updated:
16
17* Users running CMake may set this variable in the cache
18  (e.g. ``-DCMAKE_POLICY_DEFAULT_CMP<NNNN>=<OLD|NEW>``).  Set it to ``OLD``
19  to quiet a policy warning while using old behavior or to ``NEW`` to
20  try building the project with new behavior.
21
22* Projects may set this variable before a call to :command:`add_subdirectory`
23  that adds a third-party project in order to set its policies without
24  modifying third-party code.
25