Documentation/git-repack.txt: document new -A behaviour
Add paragraph for the -A option, and describe the new behaviour that makes unreachable objects loose. Signed-off-by: Chris Frey <cdfrey@foursquare.net> Signed-off-by: Junio C Hamano <gitster@pobox.com>
Chris Frey committed
May 15, 2008 at 22:37 UTC
bbefaa1f38a47e06c32612edc2f64a0168cc40b2
1 file changed
+13
-1
Documentation/git-repack.txt
+13
-1
@@ -8,7 +8,7 @@ git-repack - Pack unpacked objects in a repository
8
9
SYNOPSIS
10
--------
11
-'git-repack' [-a] [-d] [-f] [-l] [-n] [-q] [--window=N] [--depth=N]
11
+'git-repack' [-a] [-A] [-d] [-f] [-l] [-n] [-q] [--window=N] [--depth=N]
12
13
DESCRIPTION
14
-----------
@@ -37,6 +37,18 @@ OPTIONS
37
leaves behind, but `git fsck --full` shows as
38
dangling.
39
40
+-A::
41
+ Same as `-a`, but any unreachable objects in a previous
42
+ pack become loose, unpacked objects, instead of being
43
+ left in the old pack. Unreachable objects are never
44
+ intentionally added to a pack, even when repacking.
45
+ When used with '-d', this option
46
+ prevents unreachable objects from being immediately
47
+ deleted by way of being left in the old pack and then
48
+ removed. Instead, the loose unreachable objects
49
+ will be pruned according to normal expiry rules
50
+ with the next linkgit:git-gc[1].
51
+
52
-d::
53
After packing, if the newly created packs make some
54
existing packs redundant, remove the redundant packs.