path: root/Documentation/git-gc.txt
diff options
authorNguyễn Thái Ngọc Duy <>2018-04-15 15:36:15 (GMT)
committerJunio C Hamano <>2018-04-16 04:52:29 (GMT)
commit55dfe13df9bb38809bc45b8d6d5c7f5bf0470c11 (patch)
tree17ae0d2ce6d7525a2042e691166c51124736d048 /Documentation/git-gc.txt
parentae4e89e549b76b561a1c384dd7314c9b671c22bc (diff)
gc: add gc.bigPackThreshold config
The --keep-largest-pack option is not very convenient to use because you need to tell gc to do this explicitly (and probably on just a few large repos). Add a config key that enables this mode when packs larger than a limit are found. Note that there's a slight behavior difference compared to --keep-largest-pack: all packs larger than the threshold are kept, not just the largest one. Signed-off-by: Nguyễn Thái Ngọc Duy <> Signed-off-by: Junio C Hamano <>
Diffstat (limited to 'Documentation/git-gc.txt')
1 files changed, 4 insertions, 2 deletions
diff --git a/Documentation/git-gc.txt b/Documentation/git-gc.txt
index 8f90323..649fadd 100644
--- a/Documentation/git-gc.txt
+++ b/Documentation/git-gc.txt
@@ -56,7 +56,8 @@ single pack using `git repack -d -l`. Setting the value of ``
to 0 disables automatic packing of loose objects.
If the number of packs exceeds the value of `gc.autoPackLimit`,
-then existing packs (except those marked with a `.keep` file)
+then existing packs (except those marked with a `.keep` file
+or over `gc.bigPackThreshold` limit)
are consolidated into a single pack by using the `-A` option of
'git repack'. Setting `gc.autoPackLimit` to 0 disables
automatic consolidation of packs.
@@ -86,7 +87,8 @@ be performed as well.
All packs except the largest pack and those marked with a
- `.keep` files are consolidated into a single pack.
+ `.keep` files are consolidated into a single pack. When this
+ option is used, `gc.bigPackThreshold` is ignored.