summaryrefslogtreecommitdiffstats
path: root/Help/policy/CMP0118.rst
blob: 00afadf146d8927bb8ed2442c127b74cdcf32e33 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
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