diff options
| author | Michael Hirsch <scivision@users.noreply.github.com> | 2022-08-22 03:46:57 (GMT) |
|---|---|---|
| committer | Craig Scott <craig.scott@crascit.com> | 2022-08-23 12:42:06 (GMT) |
| commit | 666b3c6f1305e4cb9d42bead935f95debb6cb543 (patch) | |
| tree | 4f0a475f22bddbb5fc858367a23d2eab1bc93c36 /Help/command/file.rst | |
| parent | 87a40b720a53ea70bfa4466a52aa696e1940cd0d (diff) | |
| download | CMake-666b3c6f1305e4cb9d42bead935f95debb6cb543.zip CMake-666b3c6f1305e4cb9d42bead935f95debb6cb543.tar.gz CMake-666b3c6f1305e4cb9d42bead935f95debb6cb543.tar.bz2 | |
Help: Clarify file(DOWNLOAD) behavior for existing file with same hash
Diffstat (limited to 'Help/command/file.rst')
| -rw-r--r-- | Help/command/file.rst | 7 |
1 files changed, 5 insertions, 2 deletions
diff --git a/Help/command/file.rst b/Help/command/file.rst index 3374d2d..fbe2a81 100644 --- a/Help/command/file.rst +++ b/Help/command/file.rst @@ -1121,8 +1121,11 @@ Additional options to ``DOWNLOAD`` are: Verify that the downloaded content hash matches the expected value, where ``ALGO`` is one of the algorithms supported by ``file(<HASH>)``. - If it does not match, the operation fails with an error. It is an error to - specify this if ``DOWNLOAD`` is not given a ``<file>``. + If the file already exists and matches the hash, the download is skipped. + If the file already exists and does not match the hash, the file is + downloaded again. If after download the file does not match the hash, the + operation fails with an error. It is an error to specify this option if + ``DOWNLOAD`` is not given a ``<file>``. ``EXPECTED_MD5 <value>`` Historical short-hand for ``EXPECTED_HASH MD5=<value>``. It is an error to |