summaryrefslogtreecommitdiffstats
path: root/Help/policy/CMP0071.rst
diff options
context:
space:
mode:
authorSebastian Holtermann <sebholt@xwmw.org>2017-07-16 14:51:14 (GMT)
committerSebastian Holtermann <sebholt@xwmw.org>2017-07-18 16:11:31 (GMT)
commitdca5df16c51dd9426f415ed7943402036e0ad08c (patch)
tree658b847663124c0321ba62f4436c4c604cde691c /Help/policy/CMP0071.rst
parentec049641c46eb788b25713e5d96ff32c89f0e819 (diff)
downloadCMake-dca5df16c51dd9426f415ed7943402036e0ad08c.zip
CMake-dca5df16c51dd9426f415ed7943402036e0ad08c.tar.gz
CMake-dca5df16c51dd9426f415ed7943402036e0ad08c.tar.bz2
Autogen: Process GENERATED files. Add CMP0071.
This lets AUTOMOC and AUTOUIC process GENERATED files which used to be ignored before. A new policy CMP0071 ensures that the old behavior of ignoring GENERATED files is enabled when the CMake compatibility version CMAKE_MINIMUM_REQUIRED is < 3.10. Closes #16186
Diffstat (limited to 'Help/policy/CMP0071.rst')
-rw-r--r--Help/policy/CMP0071.rst34
1 files changed, 34 insertions, 0 deletions
diff --git a/Help/policy/CMP0071.rst b/Help/policy/CMP0071.rst
new file mode 100644
index 0000000..61f14dc
--- /dev/null
+++ b/Help/policy/CMP0071.rst
@@ -0,0 +1,34 @@
+CMP0071
+-------
+
+Let :prop_tgt:`AUTOMOC` and :prop_tgt:`AUTOUIC` process
+:prop_sf:`GENERATED` files.
+
+CMake 3.10 and newer process regular *and* :prop_sf:`GENERATED` source files
+in :prop_tgt:`AUTOMOC` and :prop_tgt:`AUTOUIC`.
+In CMake 3.9 and lower, only regular source files were processed in
+:prop_tgt:`AUTOMOC` and :prop_tgt:`AUTOUIC`,
+:prop_sf:`GENERATED` source files were ignored.
+
+This policy affects how :prop_tgt:`AUTOMOC` and :prop_tgt:`AUTOUIC` process
+source files that are :prop_sf:`GENERATED`.
+
+The ``OLD`` behavior for this policy is to *ignore* :prop_sf:`GENERATED`
+source files in :prop_tgt:`AUTOMOC` and :prop_tgt:`AUTOUIC`.
+
+The ``NEW`` behavior for this policy is to process :prop_sf:`GENERATED`
+source files in :prop_tgt:`AUTOMOC` and :prop_tgt:`AUTOUIC` just like regular
+source files.
+
+.. note::
+ To exclude source files from :prop_tgt:`AUTOMOC` and :prop_tgt:`AUTOUIC`
+ processing, the boolean source file properties
+ :prop_sf:`SKIP_AUTOMOC`, :prop_sf:`SKIP_AUTOUIC` and :prop_sf:`SKIP_AUTOGEN`
+ can be set accordingly.
+
+This policy was introduced in CMake version 3.10. CMake version
+|release| warns when the policy is not set and uses ``OLD`` behavior.
+Use the :command:`cmake_policy` command to set it to ``OLD`` or ``NEW``
+explicitly.
+
+.. include:: DEPRECATED.txt