File: CMAKE_POLICY_VERSION_MINIMUM.rst

package info (click to toggle)
cmake 4.2.3-2
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid
  • size: 152,456 kB
  • sloc: ansic: 403,896; cpp: 303,920; sh: 4,105; python: 3,583; yacc: 3,106; lex: 1,279; f90: 538; asm: 471; lisp: 375; cs: 270; java: 266; fortran: 239; objc: 215; perl: 213; xml: 198; makefile: 111; javascript: 83; pascal: 63; tcl: 55; php: 25; ruby: 22
file content (27 lines) | stat: -rw-r--r-- 1,180 bytes parent folder | download | duplicates (2)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
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.