summaryrefslogtreecommitdiff
path: root/Help
diff options
context:
space:
mode:
authorBrad King <brad.king@kitware.com>2022-02-16 14:37:20 +0000
committerKitware Robot <kwrobot@kitware.com>2022-02-16 09:37:33 -0500
commitc46ed01fa0e73fa8a7341961937bc6c3c8f4cd39 (patch)
tree9a5d2779be2844199e3a651af645e6af2d054958 /Help
parent82acb050187af820e482c01ac782ec95223f41de (diff)
parent231872ddb0bb86a039e78e0b2f10d354a71938b2 (diff)
downloadcmake-c46ed01fa0e73fa8a7341961937bc6c3c8f4cd39.tar.gz
Merge topic 'file-download-range'
231872ddb0 file(DOWNLOAD): Add options to download a range Acked-by: Kitware Robot <kwrobot@kitware.com> Acked-by: buildbot <buildbot@kitware.com> Merge-request: !6986
Diffstat (limited to 'Help')
-rw-r--r--Help/command/file.rst12
-rw-r--r--Help/release/dev/file-download-range.rst6
2 files changed, 18 insertions, 0 deletions
diff --git a/Help/command/file.rst b/Help/command/file.rst
index 799b6ff106..2769577852 100644
--- a/Help/command/file.rst
+++ b/Help/command/file.rst
@@ -1128,6 +1128,18 @@ Additional options to ``DOWNLOAD`` are:
Historical short-hand for ``EXPECTED_HASH MD5=<value>``. It is an error to
specify this if ``DOWNLOAD`` is not given a ``<file>``.
+``RANGE_START <value>``
+ .. versionadded:: 3.24
+
+ Offset of the start of the range in file in bytes. Could be omitted to
+ download up to the specified ``RANGE_END``.
+
+``RANGE_END <value>``
+ .. versionadded:: 3.24
+
+ Offset of the end of the range in file in bytes. Could be omitted to
+ download everything from the specified ``RANGE_START`` to the end of file.
+
Locking
^^^^^^^
diff --git a/Help/release/dev/file-download-range.rst b/Help/release/dev/file-download-range.rst
new file mode 100644
index 0000000000..194100d46b
--- /dev/null
+++ b/Help/release/dev/file-download-range.rst
@@ -0,0 +1,6 @@
+file-download-range
+-------------------
+
+* Add the fields ``RANGE_START`` and ``RANGE_END`` to ``file(DOWNLOAD)``.
+ Those fields provide a convenient way to specify the range, passed to the
+ libcurl, which can be useful for downloading parts of big binary files.