summaryrefslogtreecommitdiffstats
path: root/Help
diff options
context:
space:
mode:
authorBrad King <brad.king@kitware.com>2022-11-18 14:40:06 (GMT)
committerKitware Robot <kwrobot@kitware.com>2022-11-18 14:40:13 (GMT)
commit43918087123d5ec5b6df3b7cb56c123a7adc5b90 (patch)
tree71066a7024010ff4da3ac7da033ecb3b3ae65106 /Help
parent0784261a6808989bd9fed9f7f30ac5ac00be8bf6 (diff)
parentd34986036fdc0dfa85a2d85a4fe5bce0368b1187 (diff)
downloadCMake-43918087123d5ec5b6df3b7cb56c123a7adc5b90.zip
CMake-43918087123d5ec5b6df3b7cb56c123a7adc5b90.tar.gz
CMake-43918087123d5ec5b6df3b7cb56c123a7adc5b90.tar.bz2
Merge topic 'file-COPY_FILE-retry'
d34986036f ExternalData: Improve robustness on Windows to copy a data object to a file efa9eec040 file(COPY_FILE): Add option to retry on Windows if input access fails fa518188d8 cmSystemTools: Remove unused CopySingleFile overload Acked-by: Kitware Robot <kwrobot@kitware.com> Acked-by: buildbot <buildbot@kitware.com> Merge-request: !7934
Diffstat (limited to 'Help')
-rw-r--r--Help/command/file.rst11
1 files changed, 10 insertions, 1 deletions
diff --git a/Help/command/file.rst b/Help/command/file.rst
index 2348937..df895d0 100644
--- a/Help/command/file.rst
+++ b/Help/command/file.rst
@@ -750,7 +750,8 @@ The options are:
file(COPY_FILE <oldname> <newname>
[RESULT <result>]
- [ONLY_IF_DIFFERENT])
+ [ONLY_IF_DIFFERENT]
+ [INPUT_MAY_BE_RECENT])
.. versionadded:: 3.21
@@ -769,6 +770,14 @@ The options are:
contents are already the same as ``<oldname>`` (this avoids updating
``<newname>``'s timestamp).
+``INPUT_MAY_BE_RECENT``
+ .. versionadded:: 3.26
+
+ Tell CMake that the input file may have been recently created. This is
+ meaningful only on Windows, where files may be inaccessible for a short
+ time after they are created. With this option, if permission is denied,
+ CMake will retry reading the input a few times.
+
This sub-command has some similarities to :command:`configure_file` with the
``COPYONLY`` option. An important difference is that :command:`configure_file`
creates a dependency on the source file, so CMake will be re-run if it changes.