Autogenerated man pages for v1.2.4-gf61c2

[git.git] / man1 / git-pack-objects.1

diff --git a/man1/git-pack-objects.1 b/man1/git-pack-objects.1
index 599771c..3862b62 100755 (executable)
--- a/man1/git-pack-objects.1
+++ b/man1/git-pack-objects.1
@@ -19,11 +19,14 @@
 ..
 .TH "GIT-PACK-OBJECTS" 1 "" "" ""
 .SH NAME
-git-pack-objects \- Create a packed archive of objects.
+git-pack-objects \- Create a packed archive of objects
 .SH "SYNOPSIS"
 
-
-git\-pack\-objects [\-\-non\-empty] [\-\-local] [\-\-incremental] [\-\-window=N] [\-\-depth=N] {\-\-stdout | base\-name} < object\-list
+.nf
+\fIgit\-pack\-objects\fR [\-q] [\-\-no\-reuse\-delta] [\-\-non\-empty]
+        [\-\-local] [\-\-incremental] [\-\-window=N] [\-\-depth=N]
+        {\-\-stdout | base\-name} < object\-list
+.fi
 
 .SH "DESCRIPTION"
 
@@ -34,11 +37,14 @@ Reads list of objects from the standard input, and writes a packed archive with
 A packed archive is an efficient way to transfer set of objects between two repositories, and also is an archival format which is efficient to access\&. The packed archive format (\&.pack) is designed to be unpackable without having anything else, but for random access, accompanied with the pack index file (\&.idx)\&.
 
 
-git\-unpack\-objects command can read the packed archive and expand the objects contained in the pack into "one\-file one\-object" format; this is typically done by the smart\-pull commands when a pack is created on\-the\-fly for efficient network transport by their peers\&.
+\fIgit\-unpack\-objects\fR command can read the packed archive and expand the objects contained in the pack into "one\-file one\-object" format; this is typically done by the smart\-pull commands when a pack is created on\-the\-fly for efficient network transport by their peers\&.
 
 
 Placing both in the pack/ subdirectory of $GIT_OBJECT_DIRECTORY (or any of the directories on $GIT_ALTERNATE_OBJECT_DIRECTORIES) enables git to read from such an archive\&.
 
+
+In a packed archive, an object is either stored as a compressed whole, or as a difference from some other object\&. The latter is often called a delta\&.
+
 .SH "OPTIONS"
 
 .TP
@@ -65,6 +71,14 @@ This flag is similar to \-\-incremental; instead of ignoring all packed objects,
 \-\-non\-empty
 Only create a packed archive if it would contain at least one object\&.
 
+.TP
+\-q
+This flag makes the command not to report its progress on the standard error stream\&.
+
+.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\&.
+
 .SH "AUTHOR"
 
 
@@ -75,7 +89,7 @@ Written by Linus Torvalds <torvalds@osdl\&.org>
 
 Documentation by Junio C Hamano
 
-.SH "SEE-ALSO"
+.SH "SEE ALSO"
 
 
 \fBgit\-repack\fR(1) \fBgit\-prune\-packed\fR(1)