[Cmake-commits] CMake branch, master, updated. v3.10.1-721-g89d1274

[Kitware Robot]

This is an automated email from the git hooks/post-receive script. It was
generated because a ref change was pushed to the repository containing
the project "CMake".

The branch, master has been updated
       via  89d12746306571a323549ad0f8d11284999053d5 (commit)
       via  11615b297fcb34fe1e51f74a66e72cc70efdf703 (commit)
      from  b9bada655ec1a68d65a2536f300c9d6f9cd7aabc (commit)

Those revisions listed above that are new to this repository have
not appeared on any other notification email; so we list those
revisions in full, below.

- Log -----------------------------------------------------------------
https://cmake.org/gitweb?p=cmake.git;a=commitdiff;h=89d12746306571a323549ad0f8d11284999053d5
commit 89d12746306571a323549ad0f8d11284999053d5
Merge: b9bada6 11615b2
Author:     Craig Scott <craig.scott at crascit.com>
AuthorDate: Tue Jan 9 10:05:32 2018 +0000
Commit:     Kitware Robot <kwrobot at kitware.com>
CommitDate: Tue Jan 9 05:05:41 2018 -0500

    Merge topic 'improve_generated_property_docs'
    
    11615b29 GENERATED: Improve the documentation of the GENERATED file property
    
    Acked-by: Kitware Robot <kwrobot at kitware.com>
    Merge-request: !1630


https://cmake.org/gitweb?p=cmake.git;a=commitdiff;h=11615b297fcb34fe1e51f74a66e72cc70efdf703
commit 11615b297fcb34fe1e51f74a66e72cc70efdf703
Author:     Robert Maynard <robert.maynard at kitware.com>
AuthorDate: Wed Jan 3 09:38:20 2018 -0500
Commit:     Robert Maynard <robert.maynard at kitware.com>
CommitDate: Mon Jan 8 09:12:33 2018 -0500

    GENERATED: Improve the documentation of the GENERATED file property

diff --git a/Help/prop_sf/GENERATED.rst b/Help/prop_sf/GENERATED.rst
index a3aa127..d430ee2 100644
--- a/Help/prop_sf/GENERATED.rst
+++ b/Help/prop_sf/GENERATED.rst
@@ -1,8 +1,23 @@
 GENERATED
 ---------
 
-Is this source file generated as part of the build process.
+Is this source file generated as part of the build or CMake process.
 
-If a source file is generated by the build process CMake will handle
-it differently in terms of dependency checking etc.  Otherwise having
-a non-existent source file could create problems.
+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 validity
+checks. Generated files are created by the execution of commands such as
+:command:`add_custom_command` and :command:`file(GENERATE)`.
+
+When a generated file created by an :command:`add_custom_command` command
+is explicitly listed as a source file for any target in the same
+directory scope (which usually means the same ``CMakeLists.txt`` file),
+CMake will automatically create a dependency to make sure the file is
+generated before building that target.
+
+Generated sources may be hidden in some IDE tools, while in others they might
+be shown. For the special case of sources generated by CMake's :prop_tgt:`AUTOMOC`
+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.

-----------------------------------------------------------------------

Summary of changes:
 Help/prop_sf/GENERATED.rst |   23 +++++++++++++++++++----
 1 file changed, 19 insertions(+), 4 deletions(-)


hooks/post-receive
-- 
CMake