[PATCH] git-repack(1): document --window and --depth

Jonas Fonseca· Sep 17, 2006, 11:02 UTC · lore

Copy and pasted from git-pack-objects(1).

Signed-off-by: Jonas Fonseca <fonseca@diku.dk>
---
 Documentation/git-repack.txt |   12 +++++++++++-
 1 files changed, 11 insertions(+), 1 deletions(-)

Show changes to Documentation/git-repack.txt +11 −1

diff --git a/Documentation/git-repack.txt b/Documentation/git-repack.txt
index 9516227..49f7e0a 100644
--- a/Documentation/git-repack.txt
+++ b/Documentation/git-repack.txt
@@ -9,7 +9,7 @@ objects into pack files.
 
 SYNOPSIS
 --------
-'git-repack' [-a] [-d] [-f] [-l] [-n] [-q]
+'git-repack' [-a] [-d] [-f] [-l] [-n] [-q] [--window=N] [--depth=N]
 
 DESCRIPTION
 -----------
@@ -56,6 +56,16 @@ OPTIONS
         Do not update the server information with
         `git update-server-info`.
 
+--window=[N], --depth=[N]::
+	These two options affects how the objects contained in the pack are
+	stored using delta compression. The objects are first internally
+	sorted by type, size and optionally names and compared against the
+	other objects within `--window` 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.
+
+
 Author
 ------
 Written by Linus Torvalds <torvalds@osdl.org>

-- 
1.4.2.g39f1

-- 
Jonas Fonseca

Junio C Hamano· Sep 17, 2006, 21:18 UTC · re: Jonas Fonseca · lore

Re: [PATCH] git-repack(1): document --window and --depth

Jonas Fonseca <fonseca@diku.dk> writes:

> Copy and pasted from git-pack-objects(1).

I've been fighting the urge to do this myself for a few months now ;-)

$ git log -S--window -- git-repack.sh
commit ccb365047a1081455b767867f0887e7b4334f9d8
Author: Linus Torvalds <torvalds@osdl.org>
Date:   Wed Apr 19 10:05:12 2006 -0700

    Allow "git repack" users to specify repacking window/depth
    
    .. but don't even bother documenting it. I don't think any normal person
    is supposed to ever really care, but it simplifies testing when you want
    to use the "git repack" wrapper rather than forcing you to use the core
    programs (which already do support the window/depth arguments, of course).

I will take your patch; I think it is useful to document this. Thanks.

patchgit-repack(1): document --window and --depth