summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorBrad King <brad.king@kitware.com>2017-04-10 14:01:00 (GMT)
committerKitware Robot <kwrobot@kitware.com>2017-04-10 14:01:11 (GMT)
commit5e95a9908858cbfeb46c456f14a1f6c9e9041b1c (patch)
tree480139f213756528c306a6d41657cb3701dc28ba
parent54d8c0db00d0eeb27dc7abf9d67df74801c8d907 (diff)
parentd039f7414f9acc28ad1e51e775e888688f51a706 (diff)
downloadCMake-5e95a9908858cbfeb46c456f14a1f6c9e9041b1c.zip
CMake-5e95a9908858cbfeb46c456f14a1f6c9e9041b1c.tar.gz
CMake-5e95a9908858cbfeb46c456f14a1f6c9e9041b1c.tar.bz2
Merge topic 'clarifyFileGenerateDocs'
d039f741 Help: Clarify file(GENERATE) only writes output file at generation phase Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !681
-rw-r--r--Help/command/file.rst5
1 files changed, 5 insertions, 0 deletions
diff --git a/Help/command/file.rst b/Help/command/file.rst
index 3e669c2..b2e4eea 100644
--- a/Help/command/file.rst
+++ b/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.
+
------------------------------------------------------------------------------
::