summaryrefslogtreecommitdiffstats
path: root/git-index-pack.html
diff options
context:
space:
mode:
authorJunio C Hamano <junio@hera.kernel.org>2006-11-08 01:33:41 +0000
committerJunio C Hamano <junio@hera.kernel.org>2006-11-08 01:33:41 +0000
commit0d3c81546c38713ca17817d884eed8f9ae6ae88b (patch)
tree466e2d6598a9a923cde52bf7c55f9294adb26379 /git-index-pack.html
parentd8c9d433c3925d52d9a78bab8de03ee3de469440 (diff)
downloadgit-htmldocs-0d3c81546c38713ca17817d884eed8f9ae6ae88b.tar.gz
Autogenerated HTML docs for v1.4.4-rc1
Diffstat (limited to 'git-index-pack.html')
-rw-r--r--git-index-pack.html77
1 files changed, 75 insertions, 2 deletions
diff --git a/git-index-pack.html b/git-index-pack.html
index aaff699b5..a92d4d892 100644
--- a/git-index-pack.html
+++ b/git-index-pack.html
@@ -272,7 +272,8 @@ git-index-pack(1) Manual Page
</div>
<h2>SYNOPSIS</h2>
<div class="sectionbody">
-<p><em>git-index-pack</em> [-o &lt;index-file&gt;] &lt;pack-file&gt;</p>
+<p><em>git-index-pack</em> [-v] [-o &lt;index-file&gt;] &lt;pack-file&gt;
+<em>git-index-pack</em> --stdin [--fix-thin] [--keep] [-v] [-o &lt;index-file&gt;] [&lt;pack-file&gt;]</p>
</div>
<h2>DESCRIPTION</h2>
<div class="sectionbody">
@@ -285,6 +286,14 @@ objects/pack/ directory of a git repository.</p>
<div class="sectionbody">
<dl>
<dt>
+-v
+</dt>
+<dd>
+<p>
+ Be verbose about what is going on, including progress status.
+</p>
+</dd>
+<dt>
-o &lt;index-file&gt;
</dt>
<dd>
@@ -297,8 +306,72 @@ objects/pack/ directory of a git repository.</p>
with .pack).
</p>
</dd>
+<dt>
+--stdin
+</dt>
+<dd>
+<p>
+ When this flag is provided, the pack is read from stdin
+ instead and a copy is then written to &lt;pack-file&gt;. If
+ &lt;pack-file&gt; is not specified, the pack is written to
+ objects/pack/ directory of the current git repository with
+ a default name determined from the pack content. If
+ &lt;pack-file&gt; is not specified consider using --keep to
+ prevent a race condition between this process and
+ <a href=":git-repack.html">:git-repack(1)</a> .
+</p>
+</dd>
+<dt>
+--fix-thin
+</dt>
+<dd>
+<p>
+ It is possible for <a href="git-pack-objects.html">git-pack-objects(1)</a> to build
+ "thin" pack, which records objects in deltified form based on
+ objects not included in the pack to reduce network traffic.
+ Those objects are expected to be present on the receiving end
+ and they must be included in the pack for that pack to be self
+ contained and indexable. Without this option any attempt to
+ index a thin pack will fail. This option only makes sense in
+ conjunction with --stdin.
+</p>
+</dd>
+<dt>
+--keep
+</dt>
+<dd>
+<p>
+ Before moving the index into its final destination
+ create an empty .keep file for the associated pack file.
+ This option is usually necessary with --stdin to prevent a
+ simultaneous <a href="git-repack.html">git-repack(1)</a> process from deleting
+ the newly constructed pack and index before refs can be
+ updated to use objects contained in the pack.
+</p>
+</dd>
+<dt>
+--keep=<em>why</em>
+</dt>
+<dd>
+<p>
+ Like --keep create a .keep file before moving the index into
+ its final destination, but rather than creating an empty file
+ place <em>why</em> followed by an LF into the .keep file. The <em>why</em>
+ message can later be searched for within all .keep files to
+ locate any which have outlived their usefulness.
+</p>
+</dd>
</dl>
</div>
+<h2>Note</h2>
+<div class="sectionbody">
+<p>Once the index has been created, the list of object names is sorted
+and the SHA1 hash of that list is printed to stdout. If --stdin was
+also used then this is prefixed by either "pack\t", or "keep\t" if a
+new .keep file was successfully created. This is useful to remove a
+.keep file used as a lock to prevent the race with <a href="git-repack.html">git-repack(1)</a>
+mentioned above.</p>
+</div>
<h2>Author</h2>
<div class="sectionbody">
<p>Written by Sergey Vlasov &lt;vsu@altlinux.ru&gt;</p>
@@ -313,7 +386,7 @@ objects/pack/ directory of a git repository.</p>
</div>
<div id="footer">
<div id="footer-text">
-Last updated 03-Oct-2006 08:41:08 UTC
+Last updated 08-Nov-2006 01:33:28 UTC
</div>
</div>
</body>