summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorLibravatar Michael J Gruber <git@drmicha.warpmail.net>2009-06-09 18:15:47 +0200
committerLibravatar Junio C Hamano <gitster@pobox.com>2009-06-09 23:47:49 -0700
commit9a8531eeba5053281e14ef14e6beb019ce17f07e (patch)
tree12e12d7a36ec3b2a0fcb9f47cb6373be429557e4
parentMerge branch 'maint' (diff)
downloadtgif-9a8531eeba5053281e14ef14e6beb019ce17f07e.tar.xz
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 <git@drmicha.warpmail.net> Helped-by: Stephen Boyd <bebarino@gmail.com> Signed-off-by: Junio C Hamano <gitster@pobox.com>
-rw-r--r--Documentation/git-repack.txt7
1 files changed, 5 insertions, 2 deletions
diff --git a/Documentation/git-repack.txt b/Documentation/git-repack.txt
index aaa8852629..c9257a10c9 100644
--- a/Documentation/git-repack.txt
+++ b/Documentation/git-repack.txt
@@ -31,11 +31,14 @@ OPTIONS
Instead of incrementally packing the unpacked objects,
pack everything referenced into a single pack.
Especially useful when packing a repository that is used
- for private development and there is no need to worry
- about people fetching via dumb protocols from it. Use
+ for private development. Use
with '-d'. This will clean up the objects that `git prune`
leaves behind, but `git fsck --full` shows as
dangling.
++
+Note that users fetching over dumb protocols will have to fetch the
+whole new pack in order to get any contained object, no matter how many
+other objects in that pack they already have locally.
-A::
Same as `-a`, unless '-d' is used. Then any unreachable