mirror of
https://github.com/Kitware/CMake.git
synced 2026-01-06 05:40:54 -06:00
577e693d3e
This was missed in commit ad3c2c0b03 (Help: Normalize and consolidate
standard policy advice paragraph, 2024-01-11, v3.29.0-rc1~124^2~2).
33 lines
1.2 KiB
ReStructuredText
33 lines
1.2 KiB
ReStructuredText
CMP0000
|
|
-------
|
|
|
|
A minimum required CMake version must be specified.
|
|
|
|
CMake requires that projects specify the version of CMake to which
|
|
they have been written. This policy has been put in place so users
|
|
trying to build the project may be told when they need to update their
|
|
CMake. Specifying a version also helps the project build with CMake
|
|
versions newer than that specified. Use the :command:`cmake_minimum_required`
|
|
command at the top of your main ``CMakeLists.txt`` file:
|
|
|
|
::
|
|
|
|
cmake_minimum_required(VERSION <major>.<minor>)
|
|
|
|
where ``<major>.<minor>`` is the version of CMake you want to support
|
|
(such as ``3.14``). The command will ensure that at least the given
|
|
version of CMake is running and help newer versions be compatible with
|
|
the project. See documentation of :command:`cmake_minimum_required` for
|
|
details.
|
|
|
|
Note that the command invocation must appear in the ``CMakeLists.txt``
|
|
file itself; a call in an included file is not sufficient. The ``OLD``
|
|
behavior was to silently ignore the missing invocation. The ``NEW``
|
|
behavior is to issue an error instead of a warning.
|
|
|
|
.. |INTRODUCED_IN_CMAKE_VERSION| replace:: 2.6.0
|
|
.. |WARNS_OR_DOES_NOT_WARN| replace:: warns
|
|
.. include:: STANDARD_ADVICE.txt
|
|
|
|
.. include:: DEPRECATED.txt
|