diff options
| author | Brad King <brad.king@kitware.com> | 2022-11-18 14:40:06 (GMT) |
|---|---|---|
| committer | Kitware Robot <kwrobot@kitware.com> | 2022-11-18 14:40:13 (GMT) |
| commit | 43918087123d5ec5b6df3b7cb56c123a7adc5b90 (patch) | |
| tree | 71066a7024010ff4da3ac7da033ecb3b3ae65106 /Help/command/file.rst | |
| parent | 0784261a6808989bd9fed9f7f30ac5ac00be8bf6 (diff) | |
| parent | d34986036fdc0dfa85a2d85a4fe5bce0368b1187 (diff) | |
| download | CMake-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/command/file.rst')
| -rw-r--r-- | Help/command/file.rst | 11 |
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. |