Autogenerated HTML docs for v1.4.3.1-g178e
authorJunio C Hamano <junio@hera.kernel.org>
Mon, 23 Oct 2006 07:18:50 +0000 (07:18 +0000)
committerJunio C Hamano <junio@hera.kernel.org>
Mon, 23 Oct 2006 07:18:50 +0000 (07:18 +0000)
config.txt
git-pack-objects.html
git-pack-objects.txt
git-repack.html
git-repack.txt
git-repo-config.html

index 84e38911eeecd3f4e5f195ada61cb9bc831a4627..05d657444fc31768f9bf9909324b708ac6fcfd46 100644 (file)
@@ -230,6 +230,10 @@ pull.octopus::
 pull.twohead::
        The default merge strategy to use when pulling a single branch.
 
+repack.usedeltabaseoffset::
+       Allow gitlink:git-repack[1] to create packs that uses
+       delta-base offset.  Defaults to false.
+
 show.difftree::
        The default gitlink:git-diff-tree[1] arguments to be used
        for gitlink:git-show[1].
index b9cd911cc3ed2bbb9348850b553966798818c8c7..74fd36eb06fd94179150413b78caf4fa4d1bb2c1 100644 (file)
@@ -273,7 +273,7 @@ git-pack-objects(1) Manual Page
 <h2>SYNOPSIS</h2>\r
 <div class="sectionbody">\r
 <div class="verseblock">\r
-<div class="content"><em>git-pack-objects</em> [-q] [--no-reuse-delta] [--non-empty]\r
+<div class="content"><em>git-pack-objects</em> [-q] [--no-reuse-delta] [--delta-base-offset] [--non-empty]\r
         [--local] [--incremental] [--window=N] [--depth=N]\r
         [--revs [--unpacked | --all]*] [--stdout | base-name] &lt; object-list</div></div>\r
 </div>\r
@@ -425,6 +425,22 @@ base-name
         but compute them from scratch.\r
 </p>\r
 </dd>\r
+<dt>\r
+--delta-base-offset\r
+</dt>\r
+<dd>\r
+<p>\r
+        A packed archive can express base object of a delta as\r
+        either 20-byte object name or as an offset in the\r
+        stream, but older version of git does not understand the\r
+        latter.  By default, git-pack-objects only uses the\r
+        former format for better compatibility.  This option\r
+        allows the command to use the latter format for\r
+        compactness.  Depending on the average delta chain\r
+        length, this option typically shrinks the resulting\r
+        packfile by 3-5 per-cent.\r
+</p>\r
+</dd>\r
 </dl>\r
 </div>\r
 <h2>Author</h2>\r
@@ -447,7 +463,7 @@ base-name
 </div>\r
 <div id="footer">\r
 <div id="footer-text">\r
-Last updated 08-Oct-2006 08:47:46 UTC\r
+Last updated 23-Oct-2006 07:18:39 UTC\r
 </div>\r
 </div>\r
 </body>\r
index f52e8fa8bfb6cd1b121eab7e8594368f5b1c6513..a1e55054bd544848605eec8bfaa2cc29ac94f3d0 100644 (file)
@@ -9,7 +9,7 @@ git-pack-objects - Create a packed archive of objects
 SYNOPSIS
 --------
 [verse]
-'git-pack-objects' [-q] [--no-reuse-delta] [--non-empty]
+'git-pack-objects' [-q] [--no-reuse-delta] [--delta-base-offset] [--non-empty]
        [--local] [--incremental] [--window=N] [--depth=N]
        [--revs [--unpacked | --all]*] [--stdout | base-name] < object-list
 
@@ -111,6 +111,17 @@ base-name::
        This flag tells the command not to reuse existing deltas
        but compute them from scratch.
 
+--delta-base-offset::
+       A packed archive can express base object of a delta as
+       either 20-byte object name or as an offset in the
+       stream, but older version of git does not understand the
+       latter.  By default, git-pack-objects only uses the
+       former format for better compatibility.  This option
+       allows the command to use the latter format for
+       compactness.  Depending on the average delta chain
+       length, this option typically shrinks the resulting
+       packfile by 3-5 per-cent.
+
 
 Author
 ------
index 7afbe5625f57b8e12bee0c0016ff76c6218a134f..6d4c22adbed076071e9f9b6df797e9ec8983de94 100644 (file)
@@ -363,6 +363,18 @@ engines, disk storage, etc.</p>
 </dd>\r
 </dl>\r
 </div>\r
+<h2>Configuration</h2>\r
+<div class="sectionbody">\r
+<p>When configuration variable <tt>repack.UseDeltaBaseOffset</tt> is set\r
+for the repository, the command passes <tt>--delta-base-offset</tt>\r
+option to <tt>git-pack-objects</tt>; this typically results in slightly\r
+smaller packs, but the generated packs are incompatible with\r
+versions of git older than (and including) v1.4.3; do not set\r
+the variable in a repository that older version of git needs to\r
+be able to read (this includes repositories from which packs can\r
+be copied out over http or rsync, and people who obtained packs\r
+that way can try to use older git with it).</p>\r
+</div>\r
 <h2>Author</h2>\r
 <div class="sectionbody">\r
 <p>Written by Linus Torvalds &lt;torvalds@osdl.org&gt;</p>\r
@@ -382,7 +394,7 @@ engines, disk storage, etc.</p>
 </div>\r
 <div id="footer">\r
 <div id="footer-text">\r
-Last updated 08-Oct-2006 08:47:47 UTC\r
+Last updated 23-Oct-2006 07:18:40 UTC\r
 </div>\r
 </div>\r
 </body>\r
index d2eaa0995ded915f89d436e4501c5ae667822642..0fa47e3b018815ffa9de23725737fe2b599eaead 100644 (file)
@@ -67,6 +67,20 @@ OPTIONS
        The default value for both --window and --depth is 10.
 
 
+Configuration
+-------------
+
+When configuration variable `repack.UseDeltaBaseOffset` is set
+for the repository, the command passes `--delta-base-offset`
+option to `git-pack-objects`; this typically results in slightly
+smaller packs, but the generated packs are incompatible with
+versions of git older than (and including) v1.4.3; do not set
+the variable in a repository that older version of git needs to
+be able to read (this includes repositories from which packs can
+be copied out over http or rsync, and people who obtained packs
+that way can try to use older git with it).
+
+
 Author
 ------
 Written by Linus Torvalds <torvalds@osdl.org>
index 98591805a08715a82b4adc24af1953ada404c8fd..3a7dc5a5473b5ff86a10dd383a5ce9900b46f46f 100644 (file)
@@ -914,6 +914,15 @@ pull.twohead
 </p>\r
 </dd>\r
 <dt>\r
+repack.usedeltabaseoffset\r
+</dt>\r
+<dd>\r
+<p>\r
+        Allow <a href="git-repack.html">git-repack(1)</a> to create packs that uses\r
+        delta-base offset.  Defaults to false.\r
+</p>\r
+</dd>\r
+<dt>\r
 show.difftree\r
 </dt>\r
 <dd>\r
@@ -1036,7 +1045,7 @@ receive.denyNonFastforwads
 </div>\r
 <div id="footer">\r
 <div id="footer-text">\r
-Last updated 03-Oct-2006 08:41:22 UTC\r
+Last updated 23-Oct-2006 07:18:40 UTC\r
 </div>\r
 </div>\r
 </body>\r