mirror of
https://github.com/reactos/CMake.git
synced 2024-12-14 15:19:39 +00:00
7cbab17871
Historically CMake used three version components for the feature level.
We released new features while incrementing only the third version
component. Since commit v2.8.2~105^2~4 (New version scheme to support
branchy workflow, 2010-04-23) we used the fourth version component for
bug-fix releases and the development date:
<major>.<minor>.<patch>[.<tweak>][-rc<n>] = Release
<major>.<minor>.<patch>.<date>[-<id>] = Development
This solidified use of three components for the feature level, and was
necessary to continue releasing 2.x versions because:
* Some existing projects performed floating-point comparisons of
${CMAKE_MAJOR_VERSION}.${CMAKE_MINOR_VERSION} to 2.x numbers
so ``x`` could never be higher than 9.
* Version 2.9.<date> was used briefly in post-2.8.0 development in
CVS prior to the transition to Git, so using it in releases may
have caused confusion.
Now that we are moving to 3.x versions, these two restrictions go away.
Therefore we now change to use only two components for the feature
level and use the scheme:
<major>.<minor>.<patch>[-rc<n>] = Release
<major>.<minor>.<date>[-<id>] = Development
52 lines
2.1 KiB
ReStructuredText
52 lines
2.1 KiB
ReStructuredText
CMAKE_VERSION
|
|
-------------
|
|
|
|
The CMake version string as three non-negative integer components
|
|
separated by ``.`` and possibly followed by ``-`` and other information.
|
|
The first two components represent the feature level and the third
|
|
component represents either a bug-fix level or development date.
|
|
|
|
Release versions and release candidate versions of CMake use the format::
|
|
|
|
<major>.<minor>.<patch>[-rc<n>]
|
|
|
|
where the ``<patch>`` component is less than ``20000000``. Development
|
|
versions of CMake use the format::
|
|
|
|
<major>.<minor>.<date>[-<id>]
|
|
|
|
where the ``<date>`` component is of format ``CCYYMMDD`` and ``<id>``
|
|
may contain arbitrary text. This represents development as of a
|
|
particular date following the ``<major>.<minor>`` feature release.
|
|
|
|
Individual component values are also available in variables:
|
|
|
|
* :variable:`CMAKE_MAJOR_VERSION`
|
|
* :variable:`CMAKE_MINOR_VERSION`
|
|
* :variable:`CMAKE_PATCH_VERSION`
|
|
* :variable:`CMAKE_TWEAK_VERSION`
|
|
|
|
Use the :command:`if` command ``VERSION_LESS``, ``VERSION_EQUAL``, or
|
|
``VERSION_GREATER`` operators to compare version string values against
|
|
``CMAKE_VERSION`` using a component-wise test. Version component
|
|
values may be 10 or larger so do not attempt to compare version
|
|
strings as floating-point numbers.
|
|
|
|
.. note::
|
|
|
|
CMake versions 2.8.2 through 2.8.12 used three components for the
|
|
feature level. Release versions represented the bug-fix level in a
|
|
fourth component, i.e. ``<major>.<minor>.<patch>[.<tweak>][-rc<n>]``.
|
|
Development versions represented the development date in the fourth
|
|
component, i.e. ``<major>.<minor>.<patch>.<date>[-<id>]``.
|
|
|
|
CMake versions prior to 2.8.2 used three components for the
|
|
feature level and had no bug-fix component. Release versions
|
|
used an even-valued second component, i.e.
|
|
``<major>.<even-minor>.<patch>[-rc<n>]``. Development versions
|
|
used an odd-valued second component with the development date as
|
|
the third component, i.e. ``<major>.<odd-minor>.<date>``.
|
|
|
|
The ``CMAKE_VERSION`` variable is defined by CMake 2.6.3 and higher.
|
|
Earlier versions defined only the individual component variables.
|