summaryrefslogtreecommitdiffstats
path: root/Help/prop_sf
diff options
context:
space:
mode:
authorDeniz Bahadir <dbahadir@benocs.com>2020-11-17 19:30:53 (GMT)
committerDeniz Bahadir <dbahadir@benocs.com>2020-11-24 16:41:02 (GMT)
commit0eb30f175e61a013db301ab1be242dd497be4add (patch)
tree854de71ab9e1ddd614b2406a59d96027c2a553f6 /Help/prop_sf
parent78c8d956050834dbbce78fb0e3f5f42dd2253fd9 (diff)
downloadCMake-0eb30f175e61a013db301ab1be242dd497be4add.zip
CMake-0eb30f175e61a013db301ab1be242dd497be4add.tar.gz
CMake-0eb30f175e61a013db301ab1be242dd497be4add.tar.bz2
GENERATED prop: Introducing policy CMP0118 and its documentation
Note: This is currently only defining the CMP0118 policy and providing its documentation, however, the implementation is still not using it.
Diffstat (limited to 'Help/prop_sf')
-rw-r--r--Help/prop_sf/GENERATED.rst11
1 files changed, 11 insertions, 0 deletions
diff --git a/Help/prop_sf/GENERATED.rst b/Help/prop_sf/GENERATED.rst
index 48ff70c..6ef4580 100644
--- a/Help/prop_sf/GENERATED.rst
+++ b/Help/prop_sf/GENERATED.rst
@@ -3,6 +3,9 @@ GENERATED
Is this source file generated as part of the build or CMake process.
+.. versionchanged:: 3.20
+ The GENERATED source file property is now visible in all directories.
+
Tells the internal CMake engine that a source file is generated by an outside
process such as another build step, or the execution of CMake itself.
This information is then used to exempt the file from any existence or
@@ -34,3 +37,11 @@ or :prop_tgt:`AUTORCC` functionality, the :prop_gbl:`AUTOGEN_SOURCE_GROUP`,
:prop_gbl:`AUTOMOC_SOURCE_GROUP` and :prop_gbl:`AUTORCC_SOURCE_GROUP` target
properties may influence where the generated sources are grouped in the project's
file lists.
+
+.. note::
+
+ Starting with CMake 3.20 the ``GENERATED`` source file property can be set
+ and retrieved from any directory scope. It is an all-or-nothing property.
+ It also can no longer be removed or unset if it was set to ``TRUE``. Policy
+ :policy:`CMP0118` was introduced to allow supporting the ``OLD`` behavior
+ for some time.