Autogenerated man pages for v1.4.3.1-g178e
authorJunio C Hamano <junio@hera.kernel.org>
Mon, 23 Oct 2006 07:18:59 +0000 (07:18 +0000)
committerJunio C Hamano <junio@hera.kernel.org>
Mon, 23 Oct 2006 07:18:59 +0000 (07:18 +0000)
man1/git-pack-objects.1
man1/git-repack.1
man1/git-repo-config.1

index ef2923ecc6dfccf4297e4da2492d1a1a274a9adf..c2c6749a0712f49b6a697ff2027f96ff6ab02a41 100755 (executable)
@@ -2,7 +2,7 @@
 .\" It was generated using the DocBook XSL Stylesheets (version 1.69.1).
 .\" Instead of manually editing it, you probably should edit the DocBook XML
 .\" source for it and then use the DocBook XSL Stylesheets to regenerate it.
-.TH "GIT\-PACK\-OBJECTS" "1" "10/08/2006" "" ""
+.TH "GIT\-PACK\-OBJECTS" "1" "10/23/2006" "" ""
 .\" disable hyphenation
 .nh
 .\" disable justification (adjust text to left margin only)
@@ -12,7 +12,7 @@ git\-pack\-objects \- Create a packed archive of objects
 .SH "SYNOPSIS"
 .sp
 .nf
-\fIgit\-pack\-objects\fR [\-q] [\-\-no\-reuse\-delta] [\-\-non\-empty]
+\fIgit\-pack\-objects\fR [\-q] [\-\-no\-reuse\-delta] [\-\-delta\-base\-offset] [\-\-non\-empty]
         [\-\-local] [\-\-incremental] [\-\-window=N] [\-\-depth=N]
         [\-\-revs [\-\-unpacked | \-\-all]*] [\-\-stdout | base\-name] < object\-list
 .fi
@@ -72,6 +72,9 @@ This flag makes the command not to report its progress on the standard error str
 .TP
 \-\-no\-reuse\-delta
 When creating a packed archive in a repository that has existing packs, the command reuses existing deltas. This sometimes results in a slightly suboptimal pack. This flag tells the command not to reuse existing deltas but compute them from scratch.
+.TP
+\-\-delta\-base\-offset
+A packed archive can express base object of a delta as either 20\-byte object name or as an offset in the stream, but older version of git does not understand the latter. By default, git\-pack\-objects only uses the former format for better compatibility. This option allows the command to use the latter format for compactness. Depending on the average delta chain length, this option typically shrinks the resulting packfile by 3\-5 per\-cent.
 .SH "AUTHOR"
 Written by Linus Torvalds <torvalds@osdl.org>
 .sp
index 7415024fca3fe6288e71ac7fe94611c09099c816..7e714f1fac504bf35f22db7d154bee696ff94cc8 100755 (executable)
@@ -2,7 +2,7 @@
 .\" It was generated using the DocBook XSL Stylesheets (version 1.69.1).
 .\" Instead of manually editing it, you probably should edit the DocBook XML
 .\" source for it and then use the DocBook XSL Stylesheets to regenerate it.
-.TH "GIT\-REPACK" "1" "10/08/2006" "" ""
+.TH "GIT\-REPACK" "1" "10/23/2006" "" ""
 .\" disable hyphenation
 .nh
 .\" disable justification (adjust text to left margin only)
@@ -60,6 +60,9 @@ These two options affect how the objects contained in the pack are stored using
 to see if using delta compression saves space.
 \-\-depth
 limits the maximum delta depth; making it too deep affects the performance on the unpacker side, because delta data needs to be applied that many times to get to the necessary object. The default value for both \-\-window and \-\-depth is 10.
+.SH "CONFIGURATION"
+When configuration variable repack.UseDeltaBaseOffset is set for the repository, the command passes \-\-delta\-base\-offset option to git\-pack\-objects; this typically results in slightly smaller packs, but the generated packs are incompatible with versions of git older than (and including) v1.4.3; do not set the variable in a repository that older version of git needs to be able to read (this includes repositories from which packs can be copied out over http or rsync, and people who obtained packs that way can try to use older git with it).
+.sp
 .SH "AUTHOR"
 Written by Linus Torvalds <torvalds@osdl.org>
 .sp
index ac56a3a54123b0f8dec6c7e0cc1d0b02833be139..5e097c7f0c4ba4f5f5bd8fb0c0c68d23bfaefb18 100755 (executable)
@@ -2,7 +2,7 @@
 .\" It was generated using the DocBook XSL Stylesheets (version 1.69.1).
 .\" Instead of manually editing it, you probably should edit the DocBook XML
 .\" source for it and then use the DocBook XSL Stylesheets to regenerate it.
-.TH "GIT\-REPO\-CONFIG" "1" "10/03/2006" "" ""
+.TH "GIT\-REPO\-CONFIG" "1" "10/23/2006" "" ""
 .\" disable hyphenation
 .nh
 .\" disable justification (adjust text to left margin only)
@@ -395,6 +395,11 @@ The default merge strategy to use when pulling multiple branches at once.
 pull.twohead
 The default merge strategy to use when pulling a single branch.
 .TP
+repack.usedeltabaseoffset
+Allow
+\fBgit\-repack\fR(1)
+to create packs that uses delta\-base offset. Defaults to false.
+.TP
 show.difftree
 The default
 \fBgit\-diff\-tree\fR(1)