path: root/Documentation
diff options
authorNguyễn Thái Ngọc Duy <>2018-05-05 08:47:16 (GMT)
committerJunio C Hamano <>2018-05-06 09:49:32 (GMT)
commit58bd77b66a83e7d8bcbc4e756ab997416d246be2 (patch)
treebc6c723f8dfb04ab9410c40c2ae1bb6e1fb4ffcc /Documentation
parent468165c1d8a442994a825f3684528361727cd8c0 (diff)
pack-objects: validation and documentation about unreachable options
These options are added in [1] [2] [3]. All these depend on running rev-list internally which is normally true since they are always used with "--all --objects" which implies --revs. But let's keep this dependency explicit. While at there, add documentation for them. These are mostly used internally by git-repack. But it's still good to not chase down the right commit message to know how they work. [1] ca11b212eb (let pack-objects do the writing of unreachable objects as loose objects - 2008-05-14) [2] 08cdfb1337 (pack-objects --keep-unreachable - 2007-09-16) [3] e26a8c4721 (repack: extend --keep-unreachable to loose objects - 2016-06-13) Signed-off-by: Nguyễn Thái Ngọc Duy <> Reviewed-by: Jeff King <> Signed-off-by: Junio C Hamano <>
Diffstat (limited to 'Documentation')
1 files changed, 13 insertions, 0 deletions
diff --git a/Documentation/git-pack-objects.txt b/Documentation/git-pack-objects.txt
index 81bc490..44245e5 100644
--- a/Documentation/git-pack-objects.txt
+++ b/Documentation/git-pack-objects.txt
@@ -267,6 +267,19 @@ Unexpected missing object will raise an error.
locally created objects [without .promisor] and objects from the
promisor remote [with .promisor].) This is used with partial clone.
+ Objects unreachable from the refs in packs named with
+ --unpacked= option are added to the resulting pack, in
+ addition to the reachable objects that are not in packs marked
+ with *.keep files. This implies `--revs`.
+ Pack unreachable loose objects (and their loose counterparts
+ removed). This implies `--revs`.
+ Keep unreachable objects in loose form. This implies `--revs`.