Merge branch 'en/ort-perf-batch-9'

[thirdparty/git.git] / Documentation / config / pack.txt

diff --git a/Documentation/config/pack.txt b/Documentation/config/pack.txt
index edac75c83f471bee7e9f560b1ec2defc13e0482e..3da4ea98e2d4b11d0ff3534efd71ceddb93d9ea8 100644 (file)
--- a/Documentation/config/pack.txt
+++ b/Documentation/config/pack.txt
@@ -27,6 +27,13 @@ Note that changing the compression level will not automatically recompress
 all existing objects. You can force recompression by passing the -F option
 to linkgit:git-repack[1].
 
+pack.allowPackReuse::
+       When true, and when reachability bitmaps are enabled,
+       pack-objects will try to send parts of the bitmapped packfile
+       verbatim. This can reduce memory and CPU usage to serve fetches,
+       but might result in sending a slightly larger pack. Defaults to
+       true.
+
 pack.island::
        An extended regular expression configuring a set of delta
        islands. See "DELTA ISLANDS" in linkgit:git-pack-objects[1]
@@ -105,6 +112,16 @@ pack.useBitmaps::
        true. You should not generally need to turn this off unless
        you are debugging pack bitmaps.
 
+pack.useSparse::
+       When true, git will default to using the '--sparse' option in
+       'git pack-objects' when the '--revs' option is present. This
+       algorithm only walks trees that appear in paths that introduce new
+       objects. This can have significant performance benefits when
+       computing a pack to send a small change. However, it is possible
+       that extra objects are added to the pack-file if the included
+       commits contain certain types of direct renames. Default is
+       `true`.
+
 pack.writeBitmaps (deprecated)::
        This is a deprecated synonym for `repack.writeBitmaps`.
 
@@ -115,6 +132,11 @@ pack.writeBitmapHashCache::
        bitmapped and non-bitmapped objects (e.g., when serving a fetch
        between an older, bitmapped pack and objects that have been
        pushed since the last gc). The downside is that it consumes 4
-       bytes per object of disk space, and that JGit's bitmap
-       implementation does not understand it, causing it to complain if
-       Git and JGit are used on the same repository. Defaults to false.
+       bytes per object of disk space. Defaults to true.
+
+pack.writeReverseIndex::
+       When true, git will write a corresponding .rev file (see:
+       link:../technical/pack-format.html[Documentation/technical/pack-format.txt])
+       for each new packfile that it writes in all places except for
+       linkgit:git-fast-import[1] and in the bulk checkin mechanism.
+       Defaults to false.