Skip to content

Commit 9a8531e

Browse files
Michael J Grubergitster
authored andcommitted
git-repack.txt: Clarify implications of -a for dumb protocols
The current text makes some users feel uneasy, worrying whether '-a' could lead to corrupt repositories. Clarify that '-a' may lead to performance issues only for dumb protocols. Signed-off-by: Michael J Gruber <[email protected]> Helped-by: Stephen Boyd <[email protected]> Signed-off-by: Junio C Hamano <[email protected]>
1 parent f4f78e6 commit 9a8531e

File tree

1 file changed

+5
-2
lines changed

1 file changed

+5
-2
lines changed

Documentation/git-repack.txt

Lines changed: 5 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -31,11 +31,14 @@ OPTIONS
3131
Instead of incrementally packing the unpacked objects,
3232
pack everything referenced into a single pack.
3333
Especially useful when packing a repository that is used
34-
for private development and there is no need to worry
35-
about people fetching via dumb protocols from it. Use
34+
for private development. Use
3635
with '-d'. This will clean up the objects that `git prune`
3736
leaves behind, but `git fsck --full` shows as
3837
dangling.
38+
+
39+
Note that users fetching over dumb protocols will have to fetch the
40+
whole new pack in order to get any contained object, no matter how many
41+
other objects in that pack they already have locally.
3942

4043
-A::
4144
Same as `-a`, unless '-d' is used. Then any unreachable

0 commit comments

Comments
 (0)