mirror of
https://github.com/Kitware/CMake.git
synced 2026-01-05 21:31:08 -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.
40 lines
1.6 KiB
ReStructuredText
40 lines
1.6 KiB
ReStructuredText
CMP0092
|
|
-------
|
|
|
|
.. versionadded:: 3.15
|
|
|
|
MSVC warning flags are not in :variable:`CMAKE_<LANG>_FLAGS` by default.
|
|
|
|
When using MSVC-like compilers in CMake 3.14 and below, warning flags
|
|
like ``/W3`` are added to :variable:`CMAKE_<LANG>_FLAGS` by default.
|
|
This is problematic for projects that want to choose a different warning
|
|
level programmatically. In particular, it requires string editing of the
|
|
:variable:`CMAKE_<LANG>_FLAGS` variables with knowledge of the
|
|
CMake builtin defaults so they can be replaced.
|
|
|
|
CMake 3.15 and above prefer to leave out warning flags from the value of
|
|
:variable:`CMAKE_<LANG>_FLAGS` by default.
|
|
|
|
This policy provides compatibility with projects that have not been updated
|
|
to expect the lack of warning flags. The policy setting takes effect as of
|
|
the first :command:`project` or :command:`enable_language` command that
|
|
initializes :variable:`CMAKE_<LANG>_FLAGS` for a given language ``<LANG>``.
|
|
|
|
.. note::
|
|
|
|
Once the policy has taken effect at the top of a project for a given
|
|
language, that choice must be used throughout the tree for that language.
|
|
In projects that have nested projects in subdirectories, be sure to
|
|
convert everything together.
|
|
|
|
The ``OLD`` behavior for this policy is to place MSVC warning flags in the
|
|
default :variable:`CMAKE_<LANG>_FLAGS` cache entries. The ``NEW`` behavior
|
|
for this policy is to *not* place MSVC warning flags in the default cache
|
|
entries.
|
|
|
|
.. |INTRODUCED_IN_CMAKE_VERSION| replace:: 3.15
|
|
.. |WARNS_OR_DOES_NOT_WARN| replace:: does *not* warn
|
|
.. include:: STANDARD_ADVICE.txt
|
|
|
|
.. include:: DEPRECATED.txt
|