@matheusbsbs / matheus-bagliano / commits / 63fba759bc
Fork 0

pack-objects: document --delta-base-offset option

Signed-off-by: Junio C Hamano <junkio@cox.net>

Junio C Hamano committed Oct 10, 2006 at 01:06 UTC 63fba759bc1d9405f362e73918096815bf8e2a15
2 files changed +13 -2
Documentation/git-pack-objects.txt
+12 -1
@@ -9,7 +9,7 @@ git-pack-objects - Create a packed archive of objects
9 SYNOPSIS
10 --------
11 [verse]
12 -'git-pack-objects' [-q] [--no-reuse-delta] [--non-empty]
12 +'git-pack-objects' [-q] [--no-reuse-delta] [--delta-base-offset] [--non-empty]
13 [--local] [--incremental] [--window=N] [--depth=N]
14 [--revs [--unpacked | --all]*] [--stdout | base-name] < object-list
15
@@ -110,6 +110,17 @@ base-name::
110 This flag tells the command not to reuse existing deltas
111 but compute them from scratch.
112
113 +--delta-base-offset::
114 + A packed archive can express base object of a delta as
115 + either 20-byte object name or as an offset in the
116 + stream, but older version of git does not understand the
117 + latter. By default, git-pack-objects only uses the
118 + former format for better compatibility. This option
119 + allows the command to use the latter format for
120 + compactness. Depending on the average delta chain
121 + length, this option typically shrinks the resulting
122 + packfile by 3-5 per-cent.
123 +
124
125 Author
126 ------
builtin-pack-objects.c
+1 -1
@@ -15,7 +15,7 @@
15 #include <sys/time.h>
16 #include <signal.h>
17
18 -static const char pack_usage[] = "git-pack-objects [-q] [--no-reuse-delta] [--non-empty] [--local] [--incremental] [--window=N] [--depth=N] [--revs [--unpacked | --all]*] [--stdout | base-name] <ref-list | <object-list]";
18 +static const char pack_usage[] = "git-pack-objects [-q] [--no-reuse-delta] [--delta-base-offset] [--non-empty] [--local] [--incremental] [--window=N] [--depth=N] [--revs [--unpacked | --all]*] [--stdout | base-name] <ref-list | <object-list]";
19
20 struct object_entry {
21 unsigned char sha1[20];