path: root/Documentation/git-repack.txt
diff options
authorJeff King <>2016-06-13 04:38:04 (GMT)
committerJunio C Hamano <>2016-06-14 20:57:45 (GMT)
commite26a8c4721ceaf4c59e33bbd4e60f777b7ea9b62 (patch)
tree621b15b1697fda207311a48baf647cce59c53c9e /Documentation/git-repack.txt
parent905f27b86ac1f50c6870a064c3b5b9d82c97a145 (diff)
repack: extend --keep-unreachable to loose objects
If you use "repack -adk" currently, we will pack all objects that are already packed into the new pack, and then drop the old packs. However, loose unreachable objects will be left as-is. In theory these are meant to expire eventually with "git prune". But if you are using "repack -k", you probably want to keep things forever and therefore do not run "git prune" at all. Meaning those loose objects may build up over time and end up fooling any object-count heuristics (such as the one done by "gc --auto", though since git-gc does not support "repack -k", this really applies to whatever custom scripts people might have driving "repack -k"). With this patch, we instead stuff any loose unreachable objects into the pack along with the already-packed unreachable objects. This may seem wasteful, but it is really no more so than using "repack -k" in the first place. We are at a slight disadvantage, in that we have no useful ordering for the result, or names to hand to the delta code. However, this is again no worse than what "repack -k" is already doing for the packed objects. The packing of these objects doesn't matter much because they should not be accessed frequently (unless they actually _do_ become referenced, but then they would get moved to a different part of the packfile during the next repack). Signed-off-by: Jeff King <> Signed-off-by: Junio C Hamano <>
Diffstat (limited to 'Documentation/git-repack.txt')
1 files changed, 2 insertions, 1 deletions
diff --git a/Documentation/git-repack.txt b/Documentation/git-repack.txt
index 68702ea..b58b6b5 100644
--- a/Documentation/git-repack.txt
+++ b/Documentation/git-repack.txt
@@ -138,7 +138,8 @@ other objects in that pack they already have locally.
When used with `-ad`, any unreachable objects from existing
packs will be appended to the end of the packfile instead of
- being removed.
+ being removed. In addition, any unreachable loose objects will
+ be packed (and their loose counterparts removed).