config: clarify compression defaults

* Clarify that core.compression provides a system-wide default to
  other compression parameters.

* Explain that the default for pack.compression, -1, is "a default
  compromise between speed and compression (currently equivalent
  to level 6)" according to zlib.h.

Signed-off-by: Brian Downing <bdowning@lavos.net>
Acked-by: Nicolas Pitre <nico@cam.org>
Signed-off-by: Junio C Hamano <gitster@pobox.com>
This commit is contained in:
Brian Downing 2007-11-19 10:58:51 -06:00 committed by Junio C Hamano
parent de1b24609b
commit dec9230941

View File

@ -226,6 +226,8 @@ core.compression::
An integer -1..9, indicating a default compression level. An integer -1..9, indicating a default compression level.
-1 is the zlib default. 0 means no compression, -1 is the zlib default. 0 means no compression,
and 1..9 are various speed/size tradeoffs, 9 being slowest. and 1..9 are various speed/size tradeoffs, 9 being slowest.
If set, this provides a default to other compression variables,
such as 'core.loosecompression' and 'pack.compression'.
core.loosecompression:: core.loosecompression::
An integer -1..9, indicating the compression level for objects that An integer -1..9, indicating the compression level for objects that
@ -622,7 +624,9 @@ pack.compression::
in a pack file. -1 is the zlib default. 0 means no in a pack file. -1 is the zlib default. 0 means no
compression, and 1..9 are various speed/size tradeoffs, 9 being compression, and 1..9 are various speed/size tradeoffs, 9 being
slowest. If not set, defaults to core.compression. If that is slowest. If not set, defaults to core.compression. If that is
not set, defaults to -1. not set, defaults to -1, the zlib default, which is "a default
compromise between speed and compression (currently equivalent
to level 6)."
pack.deltaCacheSize:: pack.deltaCacheSize::
The maximum memory in bytes used for caching deltas in The maximum memory in bytes used for caching deltas in