summaryrefslogtreecommitdiffstats
path: root/Help
diff options
context:
space:
mode:
authorBrad King <brad.king@kitware.com>2020-09-22 11:42:55 (GMT)
committerKitware Robot <kwrobot@kitware.com>2020-09-22 11:43:31 (GMT)
commit966c3263c2febfb3ff6c46312606f309ee1ab833 (patch)
treec8eba2141fe51490a9e8de90d7d1cce099cc4a2d /Help
parent674d3945159e0ae4926f885f6d42d9175b51dac1 (diff)
parent195d14e7818244789638fffd2087b8b2d0952622 (diff)
downloadCMake-966c3263c2febfb3ff6c46312606f309ee1ab833.zip
CMake-966c3263c2febfb3ff6c46312606f309ee1ab833.tar.gz
CMake-966c3263c2febfb3ff6c46312606f309ee1ab833.tar.bz2
Merge topic 'file-ARCHIVE-compression-level'
195d14e781 file(ARCHIVE_CREATE): Add option to control compression level Acked-by: Kitware Robot <kwrobot@kitware.com> Acked-by: Cristian Adam <cristian.adam@gmail.com> Merge-request: !5242
Diffstat (limited to 'Help')
-rw-r--r--Help/command/file.rst5
-rw-r--r--Help/release/dev/file-ARCHIVE-compression-level.rst5
2 files changed, 10 insertions, 0 deletions
diff --git a/Help/command/file.rst b/Help/command/file.rst
index d77ad2d..4210bd4 100644
--- a/Help/command/file.rst
+++ b/Help/command/file.rst
@@ -987,6 +987,7 @@ Archiving
PATHS <paths>...
[FORMAT <format>]
[COMPRESSION <compression>]
+ [COMPRESSION_LEVEL <compression level>]
[MTIME <mtime>]
[VERBOSE])
@@ -1004,6 +1005,10 @@ compression. The other formats use no compression by default, but can be
directed to do so with the ``COMPRESSION`` option. Valid values for
``<compression>`` are ``None``, ``BZip2``, ``GZip``, ``XZ``, and ``Zstd``.
+Compression level can be specied by using ``COMPRESSION_LEVEL`` option.
+Compression level should be between 0-9. 0 is the default compression.
+``COMPRESSION`` option must be specified for ``COMPRESSION_LEVEL``.
+
.. note::
With ``FORMAT`` set to ``raw`` only one file will be compressed with the
compression type specified by ``COMPRESSION``.
diff --git a/Help/release/dev/file-ARCHIVE-compression-level.rst b/Help/release/dev/file-ARCHIVE-compression-level.rst
new file mode 100644
index 0000000..719b694
--- /dev/null
+++ b/Help/release/dev/file-ARCHIVE-compression-level.rst
@@ -0,0 +1,5 @@
+file-ARCHIVE-compression-level
+------------------------------
+
+* The :command:`file(ARCHIVE_CREATE)` command gained a ``COMPRESSION_LEVEL``
+ option to specify the compression level.