mirror of
https://github.com/Kitware/CMake.git
synced 2026-04-21 21:58:50 -05:00
Brad King
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.
28 lines
999 B
ReStructuredText
28 lines
999 B
ReStructuredText
CMP0118
|
|
-------
|
|
|
|
.. versionadded:: 3.20
|
|
|
|
The :prop_sf:`GENERATED` source file property is now visible in all directories.
|
|
|
|
Whether or not a source file is generated is an all-or-nothing global
|
|
property of the source. Consequently, the associated ``GENERATED``
|
|
property is now visible from any directory scope, not only from the scope
|
|
for which it was set.
|
|
|
|
Additionally, the ``GENERATED`` property may now be set only to boolean
|
|
values, and may not be turned off once turned on.
|
|
|
|
The ``OLD`` behavior of this policy is to only allow ``GENERATED`` to be
|
|
visible from the directory scope for which it was set. The ``NEW``
|
|
behavior on the other hand allows it to be visible from any scope.
|
|
|
|
.. |INTRODUCED_IN_CMAKE_VERSION| replace:: 3.20
|
|
.. |WARNS_OR_DOES_NOT_WARN| replace::
|
|
does *not* warn with regard to visibility of the ``GENERATED``
|
|
property, but does warn about setting the ``GENERATED`` property
|
|
to a non-boolean value,
|
|
.. include:: STANDARD_ADVICE.txt
|
|
|
|
.. include:: DEPRECATED.txt
|