1CMP0000
2-------
3
4A minimum required CMake version must be specified.
5
6CMake requires that projects specify the version of CMake to which
7they have been written.  This policy has been put in place so users
8trying to build the project may be told when they need to update their
9CMake.  Specifying a version also helps the project build with CMake
10versions newer than that specified.  Use the :command:`cmake_minimum_required`
11command at the top of your main ``CMakeLists.txt`` file:
12
13::
14
15  cmake_minimum_required(VERSION <major>.<minor>)
16
17where ``<major>.<minor>`` is the version of CMake you want to support
18(such as ``3.14``).  The command will ensure that at least the given
19version of CMake is running and help newer versions be compatible with
20the project.  See documentation of :command:`cmake_minimum_required` for
21details.
22
23Note that the command invocation must appear in the ``CMakeLists.txt``
24file itself; a call in an included file is not sufficient.  However,
25the  :command:`cmake_policy` command may be called to set policy ``CMP0000``
26to ``OLD`` or ``NEW`` behavior explicitly.  The ``OLD`` behavior is to
27silently ignore the missing invocation.  The ``NEW`` behavior is to issue
28an error instead of a warning.  An included file may set ``CMP0000``
29explicitly to affect how this policy is enforced for the main
30``CMakeLists.txt`` file.
31
32This policy was introduced in CMake version 2.6.0.
33
34.. include:: DEPRECATED.txt
35