]> git.ipfire.org Git - thirdparty/git.git/commitdiff
archive: describe compression level option
authorBagas Sanjaya <bagasdotme@gmail.com>
Fri, 22 Oct 2021 06:45:44 +0000 (13:45 +0700)
committerJunio C Hamano <gitster@pobox.com>
Mon, 25 Oct 2021 17:08:23 +0000 (10:08 -0700)
Describe the only <extra> option in `git archive`, that is the compression
level option. Previously this option is only described for zip backend;
add description also for tar backend.

Signed-off-by: Bagas Sanjaya <bagasdotme@gmail.com>
Helped-by: Eric Sunshine <sunshine@sunshineco.com>
Signed-off-by: Junio C Hamano <gitster@pobox.com>
Documentation/git-archive.txt

index 9f8172828d70142de652bb90297e912a8e0805c7..bc4e76a7834a59a7ecfd9880d5a51bf794ca1b6c 100644 (file)
@@ -93,12 +93,19 @@ BACKEND EXTRA OPTIONS
 
 zip
 ~~~
--0::
-       Store the files instead of deflating them.
--9::
-       Highest and slowest compression level.  You can specify any
-       number from 1 to 9 to adjust compression speed and ratio.
+-<digit>::
+       Specify compression level.  Larger values allow the command
+       to spend more time to compress to smaller size.  Supported
+       values are from `-0` (store-only) to `-9` (best ratio).
+       Default is `-6` if not given.
 
+tar
+~~~
+-<number>::
+       Specify compression level. The value will be passed to the
+       compression command configured in `tar.<format>.command`. See
+       manual page of the configured command for the list of supported
+       levels and the default level if this option isn't specified.
 
 CONFIGURATION
 -------------