X-Git-Url: https://git.octo.it/?a=blobdiff_plain;f=Documentation%2Fgit-pack-objects.txt;h=4cb2e83faa76c4a251fc37686c738093b31606b4;hb=c40610422e1157e71dbc3c1a2f9e19bbe117962f;hp=caf5d0d1eed62b0a93efb2da519a7bd43efd7083;hpb=f51248eb482a7a0feacb04d02119c94d35845975;p=git.git diff --git a/Documentation/git-pack-objects.txt b/Documentation/git-pack-objects.txt index caf5d0d1..4cb2e83f 100644 --- a/Documentation/git-pack-objects.txt +++ b/Documentation/git-pack-objects.txt @@ -8,7 +8,10 @@ git-pack-objects - Create a packed archive of objects. SYNOPSIS -------- -'git-pack-objects' [--incremental] [--window=N] [--depth=N] {--stdout | base-name} < object-list +[verse] +'git-pack-objects' [-q] [--no-reuse-delta] [--non-empty] + [--local] [--incremental] [--window=N] [--depth=N] + {--stdout | base-name} < object-list DESCRIPTION @@ -32,6 +35,10 @@ 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. + OPTIONS ------- @@ -46,7 +53,7 @@ base-name:: output of the command. --stdout:: - Write the pack contents (what would have been writtin to + Write the pack contents (what would have been written to .pack file) out to the standard output. --window and --depth:: @@ -64,6 +71,27 @@ base-name:: This flag causes an object already in a pack ignored even if it appears in the standard input. +--local:: + This flag is similar to `--incremental`; instead of + ignoring all packed objects, it only ignores objects + that are packed and not in the local object store + (i.e. borrowed from an alternate). + +--non-empty:: + Only create a packed archive if it would contain at + least one object. + +-q:: + This flag makes the command not to report its progress + on the standard error stream. + +--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. + Author ------