Merge topic 'clarifyFileGenerateDocs'

d039f741 Help: Clarify file(GENERATE) only writes output file at generation phase

Acked-by: Kitware Robot <[email protected]>
Merge-request: !681

Help/command/file.rst

@@ -304,6 +304,11 @@ Exactly one ``CONTENT`` or ``INPUT`` option must be given.  A specific
 Generated files are modified on subsequent cmake runs only if their content
 is changed.
 
+Note also that ``file(GENERATE)`` does not create the output file until the
+generation phase. The output file will not yet have been written when the
+``file(GENERATE)`` command returns, it is written only after processing all
+of a project's ``CMakeLists.txt`` files.
+
 ------------------------------------------------------------------------------
 
 ::