From c7d81e16cb0f2023098ca64e33a4408b8ba80287 Mon Sep 17 00:00:00 2001 From: Sylvain Joubert Date: Tue, 4 Jul 2017 13:10:19 +0200 Subject: Help: Explicitly state that some file generations are lazy Fixes: #16856 --- Help/command/configure_file.rst | 2 ++ Help/command/file.rst | 4 ++-- 2 files changed, 4 insertions(+), 2 deletions(-) diff --git a/Help/command/configure_file.rst b/Help/command/configure_file.rst index 4304f09..6c60303 100644 --- a/Help/command/configure_file.rst +++ b/Help/command/configure_file.rst @@ -33,6 +33,8 @@ either ``#define VAR 1`` or ``#define VAR 0`` similarly. If the input file is modified the build system will re-run CMake to re-configure the file and generate the build system again. +The generated file is modified and its timestamp updated on subsequent +cmake runs only if its content is changed. The arguments are: diff --git a/Help/command/file.rst b/Help/command/file.rst index 7afb715..97466ff 100644 --- a/Help/command/file.rst +++ b/Help/command/file.rst @@ -306,8 +306,8 @@ from the input content to produce the output content. The options are: Exactly one ``CONTENT`` or ``INPUT`` option must be given. A specific ``OUTPUT`` file may be named by at most one invocation of ``file(GENERATE)``. -Generated files are modified on subsequent cmake runs only if their content -is changed. +Generated files are modified and their timestamp updated 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 -- cgit v0.12