Autogenerated HTML docs for v1.5.0-rc2-72-gdf391

1 files changed, 4 insertions, 214 deletions

diff --git a/git-fsck-objects.html b/git-fsck-objects.html
index fe336df21..8c5f8906a 100644
--- a/git-fsck-objects.html
+++ b/git-fsck-objects.html
@@ -272,226 +272,16 @@ git-fsck-objects(1) Manual Page
 </div>

 <h2>SYNOPSIS</h2>

 <div class="sectionbody">

-<div class="verseblock">

-<div class="content"><em>git-fsck-objects</em> [--tags] [--root] [--unreachable] [--cache]

-                 [--full] [--strict] [&lt;object&gt;*]</div></div>

+<p><em>git-fsck-objects</em> &#8230;</p>

 </div>

 <h2>DESCRIPTION</h2>

 <div class="sectionbody">

-<p>Verifies the connectivity and validity of the objects in the database.</p>

-</div>

-<h2>OPTIONS</h2>

-<div class="sectionbody">

-<dl>

-<dt>

-&lt;object&gt;

-</dt>

-<dd>

-<p>

-        An object to treat as the head of an unreachability trace.

-</p>

-<p>If no objects are given, git-fsck-objects defaults to using the

-index file and all SHA1 references in .git/refs/* as heads.</p>

-</dd>

-<dt>

---unreachable

-</dt>

-<dd>

-<p>

-        Print out objects that exist but that aren't readable from any

-        of the reference nodes.

-</p>

-</dd>

-<dt>

---root

-</dt>

-<dd>

-<p>

-        Report root nodes.

-</p>

-</dd>

-<dt>

---tags

-</dt>

-<dd>

-<p>

-        Report tags.

-</p>

-</dd>

-<dt>

---cache

-</dt>

-<dd>

-<p>

-        Consider any object recorded in the index also as a head node for

-        an unreachability trace.

-</p>

-</dd>

-<dt>

---full

-</dt>

-<dd>

-<p>

-        Check not just objects in GIT_OBJECT_DIRECTORY

-        ($GIT_DIR/objects), but also the ones found in alternate

-        object pools listed in GIT_ALTERNATE_OBJECT_DIRECTORIES

-        or $GIT_DIR/objects/info/alternates,

-        and in packed git archives found in $GIT_DIR/objects/pack

-        and corresponding pack subdirectories in alternate

-        object pools.

-</p>

-</dd>

-<dt>

---strict

-</dt>

-<dd>

-<p>

-        Enable more strict checking, namely to catch a file mode

-        recorded with g+w bit set, which was created by older

-        versions of git.  Existing repositories, including the

-        Linux kernel, git itself, and sparse repository have old

-        objects that triggers this check, but it is recommended

-        to check new projects with this flag.

-</p>

-</dd>

-</dl>

-<p>It tests SHA1 and general object sanity, and it does full tracking of

-the resulting reachability and everything else. It prints out any

-corruption it finds (missing or bad objects), and if you use the

-<em>--unreachable</em> flag it will also print out objects that exist but

-that aren't readable from any of the specified head nodes.</p>

-<p>So for example</p>

-<div class="literalblock">

-<div class="content">

-<pre><tt>git-fsck-objects --unreachable HEAD $(cat .git/refs/heads/*)</tt></pre>

-</div></div>

-<p>will do quite a _lot_ of verification on the tree. There are a few

-extra validity tests to be added (make sure that tree objects are

-sorted properly etc), but on the whole if "git-fsck-objects" is happy, you

-do have a valid tree.</p>

-<p>Any corrupt objects you will have to find in backups or other archives

-(i.e., you can just remove them and do an "rsync" with some other site in

-the hopes that somebody else has the object you have corrupted).</p>

-<p>Of course, "valid tree" doesn't mean that it wasn't generated by some

-evil person, and the end result might be crap. git is a revision

-tracking system, not a quality assurance system ;)</p>

-</div>

-<h2>Extracted Diagnostics</h2>

-<div class="sectionbody">

-<dl>

-<dt>

-expect dangling commits - potential heads - due to lack of head information

-</dt>

-<dd>

-<p>

-        You haven't specified any nodes as heads so it won't be

-        possible to differentiate between un-parented commits and

-        root nodes.

-</p>

-</dd>

-<dt>

-missing sha1 directory <em>&lt;dir&gt;</em>

-</dt>

-<dd>

-<p>

-        The directory holding the sha1 objects is missing.

-</p>

-</dd>

-<dt>

-unreachable &lt;type&gt; &lt;object&gt;

-</dt>

-<dd>

-<p>

-        The &lt;type&gt; object &lt;object&gt;, isn't actually referred to directly

-        or indirectly in any of the trees or commits seen. This can

-        mean that there's another root node that you're not specifying

-        or that the tree is corrupt. If you haven't missed a root node

-        then you might as well delete unreachable nodes since they

-        can't be used.

-</p>

-</dd>

-<dt>

-missing &lt;type&gt; &lt;object&gt;

-</dt>

-<dd>

-<p>

-        The &lt;type&gt; object &lt;object&gt;, is referred to but isn't present in

-        the database.

-</p>

-</dd>

-<dt>

-dangling &lt;type&gt; &lt;object&gt;

-</dt>

-<dd>

-<p>

-        The &lt;type&gt; object &lt;object&gt;, is present in the database but never

-        <em>directly</em> used. A dangling commit could be a root node.

-</p>

-</dd>

-<dt>

-warning: git-fsck-objects: tree &lt;tree&gt; has full pathnames in it

-</dt>

-<dd>

-<p>

-        And it shouldn't&#8230;

-</p>

-</dd>

-<dt>

-sha1 mismatch &lt;object&gt;

-</dt>

-<dd>

-<p>

-        The database has an object who's sha1 doesn't match the

-        database value.

-        This indicates a serious data integrity problem.

-</p>

-</dd>

-</dl>

-</div>

-<h2>Environment Variables</h2>

-<div class="sectionbody">

-<dl>

-<dt>

-GIT_OBJECT_DIRECTORY

-</dt>

-<dd>

-<p>

-        used to specify the object database root (usually $GIT_DIR/objects)

-</p>

-</dd>

-<dt>

-GIT_INDEX_FILE

-</dt>

-<dd>

-<p>

-        used to specify the index file of the index

-</p>

-</dd>

-<dt>

-GIT_ALTERNATE_OBJECT_DIRECTORIES

-</dt>

-<dd>

-<p>

-        used to specify additional object database roots (usually unset)

-</p>

-</dd>

-</dl>

-</div>

-<h2>Author</h2>

-<div class="sectionbody">

-<p>Written by Linus Torvalds &lt;torvalds@osdl.org&gt;</p>

-</div>

-<h2>Documentation</h2>

-<div class="sectionbody">

-<p>Documentation by David Greaves, Junio C Hamano and the git-list &lt;git@vger.kernel.org&gt;.</p>

-</div>

-<h2>GIT</h2>

-<div class="sectionbody">

-<p>Part of the <a href="git.html">git(7)</a> suite</p>

+<p>This is a synonym for <a href="git-fsck.html">git-fsck(1)</a>.  Please refer to the

+documentation of that command.</p>

 </div>

 <div id="footer">

 <div id="footer-text">

-Last updated 03-Oct-2006 08:41:05 UTC

+Last updated 29-Jan-2007 02:55:08 UTC

 </div>

 </div>

 </body>