|
|
|
|
CMP0118
|
|
|
|
|
-------
|
|
|
|
|
|
|
|
|
|
.. versionadded:: 3.20
|
|
|
|
|
|
|
|
|
|
:prop_sf:`GENERATED` sources may be used across directories without manual marking.
|
|
|
|
|
|
|
|
|
|
In CMake 3.19 and below, the :prop_sf:`GENERATED` source file property,
|
|
|
|
|
like other source file properties, was scoped in every directory separately.
|
|
|
|
|
If a source file was generated in one directory, projects had to manually
|
|
|
|
|
set the ``GENERATED`` property in another directory in order to use the file.
|
|
|
|
|
|
|
|
|
|
Whether or not a source file is generated is an all-or-nothing global
|
|
|
|
|
property of the source: a source is either generated or it is not.
|
|
|
|
|
CMake 3.20 and above prefer to allow source files generated in one directory
|
|
|
|
|
to be used in other directories without manually marking them as ``GENERATED``.
|
|
|
|
|
Additionally, the ``GENERATED`` property may now be set only to boolean
|
|
|
|
|
values, and may not be turned off once turned on. This policy provides
|
|
|
|
|
compatibility for projects that have not been updated for this behavior.
|
|
|
|
|
|
|
|
|
|
The ``OLD`` behavior of this policy is to allow generated files to be used
|
|
|
|
|
only in directories in which their ``GENERATED`` property has been turned on.
|
|
|
|
|
The ``NEW`` behavior of this policy is to allow generated files to be used
|
|
|
|
|
in other directories without explicitly turning on the ``GENERATED`` property
|
|
|
|
|
for those directories.
|
|
|
|
|
|
|
|
|
|
.. versionadded:: 3.30
|
|
|
|
|
|
|
|
|
|
Policy :policy:`CMP0163` additionally makes the :prop_sf:`GENERATED` source
|
|
|
|
|
file property visible to :command:`get_property` and
|
|
|
|
|
:command:`get_source_file_property` calls in other directories.
|
|
|
|
|
|
|
|
|
|
.. |INTRODUCED_IN_CMAKE_VERSION| replace:: 3.20
|
|
|
|
|
.. |WARNS_OR_DOES_NOT_WARN| replace::
|
|
|
|
|
warns about setting the ``GENERATED`` property to a non-boolean value
|
|
|
|
|
.. include:: STANDARD_ADVICE.txt
|
|
|
|
|
|
|
|
|
|
.. include:: DEPRECATED.txt
|
