X-Git-Url: https://git.octo.it/?a=blobdiff_plain;f=Documentation%2Fgit-pack-objects.txt;h=4cb2e83faa76c4a251fc37686c738093b31606b4;hb=c40610422e1157e71dbc3c1a2f9e19bbe117962f;hp=d1e93dbb372624d68fa96eb8bed141f1e76f0308;hpb=8fc66df237afce0b4318657f166b3583831949f3;p=git.git diff --git a/Documentation/git-pack-objects.txt b/Documentation/git-pack-objects.txt index d1e93dbb..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' [--local] [--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:: @@ -70,6 +77,22 @@ base-name:: 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 ------ Written by Linus Torvalds