mirror of
https://github.com/Kitware/CMake.git
synced 2026-02-12 18:19:11 -06:00
ad3c2c0b03
Every policy's documentation has a paragraph on what version of CMake introduced it, how to set the policy, and whether CMake warns if the policy is not set. The wording of this paragraph has diverged across policies over time. Factor the paragraph out into a standard advice document included by every policy.
24 lines
1015 B
ReStructuredText
24 lines
1015 B
ReStructuredText
CMP0048
|
|
-------
|
|
|
|
The :command:`project` command manages ``VERSION`` variables.
|
|
|
|
CMake version 3.0 introduced the ``VERSION`` option of the :command:`project`
|
|
command to specify a project version as well as the name. In order to keep
|
|
:variable:`PROJECT_VERSION` and related variables consistent with variable
|
|
:variable:`PROJECT_NAME` it is necessary to set the ``VERSION`` variables
|
|
to the empty string when no ``VERSION`` is given to :command:`project`.
|
|
However, this can change behavior for existing projects that set ``VERSION``
|
|
variables themselves since :command:`project` may now clear them.
|
|
This policy controls the behavior for compatibility with such projects.
|
|
|
|
The ``OLD`` behavior for this policy is to leave ``VERSION`` variables untouched.
|
|
The ``NEW`` behavior for this policy is to set ``VERSION`` as documented by the
|
|
:command:`project` command.
|
|
|
|
.. |INTRODUCED_IN_CMAKE_VERSION| replace:: 3.0
|
|
.. |WARNS_OR_DOES_NOT_WARN| replace:: warns
|
|
.. include:: STANDARD_ADVICE.txt
|
|
|
|
.. include:: DEPRECATED.txt
|