Autogenerated HTML docs for v1.8.4-21-g992c3

1 files changed, 102 insertions, 68 deletions

diff --git a/git-rev-parse.html b/git-rev-parse.html
index a53db8a6f..887ce0048 100644
--- a/git-rev-parse.html
+++ b/git-rev-parse.html
@@ -765,6 +765,9 @@ distinguish between them.</p></div>
 <div class="sect1">

 <h2 id="_options">OPTIONS</h2>

 <div class="sectionbody">

+<div class="sect2">

+<h3 id="_operation_modes">Operation Modes</h3>

+<div class="paragraph"><p>Each of these options must appear first on the command line.</p></div>

 <div class="dlist"><dl>

 <dt class="hdlist1">

 --parseopt

@@ -775,6 +778,21 @@ distinguish between them.</p></div>
 </p>

 </dd>

 <dt class="hdlist1">

+--sq-quote

+</dt>

+<dd>

+<p>

+        Use <em>git rev-parse</em> in shell quoting mode (see SQ-QUOTE

+        section below). In contrast to the <code>--sq</code> option below, this

+        mode does only quoting. Nothing else is done to command input.

+</p>

+</dd>

+</dl></div>

+</div>

+<div class="sect2">

+<h3 id="_options_for_parseopt">Options for --parseopt</h3>

+<div class="dlist"><dl>

+<dt class="hdlist1">

 --keep-dashdash

 </dt>

 <dd>

@@ -793,16 +811,11 @@ distinguish between them.</p></div>
         that take options themselves.

 </p>

 </dd>

-<dt class="hdlist1">

---sq-quote

-</dt>

-<dd>

-<p>

-        Use <em>git rev-parse</em> in shell quoting mode (see SQ-QUOTE

-        section below). In contrast to the <code>--sq</code> option below, this

-        mode does only quoting. Nothing else is done to command input.

-</p>

-</dd>

+</dl></div>

+</div>

+<div class="sect2">

+<h3 id="_options_for_filtering">Options for Filtering</h3>

+<div class="dlist"><dl>

 <dt class="hdlist1">

 --revs-only

 </dt>

@@ -837,6 +850,11 @@ distinguish between them.</p></div>
         Do not output flag parameters.

 </p>

 </dd>

+</dl></div>

+</div>

+<div class="sect2">

+<h3 id="_options_for_output">Options for Output</h3>

+<div class="dlist"><dl>

 <dt class="hdlist1">

 --default &lt;arg&gt;

 </dt>

@@ -922,49 +940,56 @@ can be used.</p></div>
 </p>

 </dd>

 <dt class="hdlist1">

---symbolic

+--abbrev-ref[=(strict|loose)]

 </dt>

 <dd>

 <p>

-        Usually the object names are output in SHA-1 form (with

-        possible <em>&#94;</em> prefix); this option makes them output in a

-        form as close to the original input as possible.

+        A non-ambiguous short name of the objects name.

+        The option core.warnAmbiguousRefs is used to select the strict

+        abbreviation mode.

 </p>

 </dd>

 <dt class="hdlist1">

---symbolic-full-name

+--short

+</dt>

+<dt class="hdlist1">

+--short=number

 </dt>

 <dd>

 <p>

-        This is similar to --symbolic, but it omits input that

-        are not refs (i.e. branch or tag names; or more

-        explicitly disambiguating "heads/master" form, when you

-        want to name the "master" branch when there is an

-        unfortunately named tag "master"), and show them as full

-        refnames (e.g. "refs/heads/master").

+        Instead of outputting the full SHA-1 values of object names try to

+        abbreviate them to a shorter unique name. When no length is specified

+        7 is used. The minimum length is 4.

 </p>

 </dd>

 <dt class="hdlist1">

---abbrev-ref[=(strict|loose)]

+--symbolic

 </dt>

 <dd>

 <p>

-        A non-ambiguous short name of the objects name.

-        The option core.warnAmbiguousRefs is used to select the strict

-        abbreviation mode.

+        Usually the object names are output in SHA-1 form (with

+        possible <em>&#94;</em> prefix); this option makes them output in a

+        form as close to the original input as possible.

 </p>

 </dd>

 <dt class="hdlist1">

---disambiguate=&lt;prefix&gt;

+--symbolic-full-name

 </dt>

 <dd>

 <p>

-        Show every object whose name begins with the given prefix.

-        The &lt;prefix&gt; must be at least 4 hexadecimal digits long to

-        avoid listing each and every object in the repository by

-        mistake.

+        This is similar to --symbolic, but it omits input that

+        are not refs (i.e. branch or tag names; or more

+        explicitly disambiguating "heads/master" form, when you

+        want to name the "master" branch when there is an

+        unfortunately named tag "master"), and show them as full

+        refnames (e.g. "refs/heads/master").

 </p>

 </dd>

+</dl></div>

+</div>

+<div class="sect2">

+<h3 id="_options_for_objects">Options for Objects</h3>

+<div class="dlist"><dl>

 <dt class="hdlist1">

 --all

 </dt>

@@ -1005,31 +1030,30 @@ shown.  If the pattern does not contain a globbing character (<code>?</code>,
 </p>

 </dd>

 <dt class="hdlist1">

---show-toplevel

-</dt>

-<dd>

-<p>

-        Show the absolute path of the top-level directory.

-</p>

-</dd>

-<dt class="hdlist1">

---show-prefix

+--disambiguate=&lt;prefix&gt;

 </dt>

 <dd>

 <p>

-        When the command is invoked from a subdirectory, show the

-        path of the current directory relative to the top-level

-        directory.

+        Show every object whose name begins with the given prefix.

+        The &lt;prefix&gt; must be at least 4 hexadecimal digits long to

+        avoid listing each and every object in the repository by

+        mistake.

 </p>

 </dd>

+</dl></div>

+</div>

+<div class="sect2">

+<h3 id="_options_for_files">Options for Files</h3>

+<div class="dlist"><dl>

 <dt class="hdlist1">

---show-cdup

+--local-env-vars

 </dt>

 <dd>

 <p>

-        When the command is invoked from a subdirectory, show the

-        path of the top-level directory relative to the current

-        directory (typically a sequence of "../", or an empty string).

+        List the GIT_* environment variables that are local to the

+        repository (e.g. GIT_DIR or GIT_WORK_TREE, but not GIT_EDITOR).

+        Only the names of the variables are listed, not their value,

+        even if they are set.

 </p>

 </dd>

 <dt class="hdlist1">

@@ -1072,29 +1096,49 @@ print a message to stderr and exit with nonzero status.</p></div>
 </p>

 </dd>

 <dt class="hdlist1">

---local-env-vars

+--resolve-git-dir &lt;path&gt;

 </dt>

 <dd>

 <p>

-        List the GIT_* environment variables that are local to the

-        repository (e.g. GIT_DIR or GIT_WORK_TREE, but not GIT_EDITOR).

-        Only the names of the variables are listed, not their value,

-        even if they are set.

+        Check if &lt;path&gt; is a valid repository or a gitfile that

+        points at a valid repository, and print the location of the

+        repository.  If &lt;path&gt; is a gitfile then the resolved path

+        to the real repository is printed.

 </p>

 </dd>

 <dt class="hdlist1">

---short

+--show-cdup

 </dt>

+<dd>

+<p>

+        When the command is invoked from a subdirectory, show the

+        path of the top-level directory relative to the current

+        directory (typically a sequence of "../", or an empty string).

+</p>

+</dd>

 <dt class="hdlist1">

---short=number

+--show-prefix

 </dt>

 <dd>

 <p>

-        Instead of outputting the full SHA-1 values of object names try to

-        abbreviate them to a shorter unique name. When no length is specified

-        7 is used. The minimum length is 4.

+        When the command is invoked from a subdirectory, show the

+        path of the current directory relative to the top-level

+        directory.

+</p>

+</dd>

+<dt class="hdlist1">

+--show-toplevel

+</dt>

+<dd>

+<p>

+        Show the absolute path of the top-level directory.

 </p>

 </dd>

+</dl></div>

+</div>

+<div class="sect2">

+<h3 id="_other_options">Other Options</h3>

+<div class="dlist"><dl>

 <dt class="hdlist1">

 --since=datestring

 </dt>

@@ -1127,20 +1171,10 @@ print a message to stderr and exit with nonzero status.</p></div>
         Flags and parameters to be parsed.

 </p>

 </dd>

-<dt class="hdlist1">

---resolve-git-dir &lt;path&gt;

-</dt>

-<dd>

-<p>

-        Check if &lt;path&gt; is a valid repository or a gitfile that

-        points at a valid repository, and print the location of the

-        repository.  If &lt;path&gt; is a gitfile then the resolved path

-        to the real repository is printed.

-</p>

-</dd>

 </dl></div>

 </div>

 </div>

+</div>

 <div class="sect1">

 <h2 id="_specifying_revisions">SPECIFYING REVISIONS</h2>

 <div class="sectionbody">

@@ -1716,7 +1750,7 @@ Similar to above:
 <div id="footnotes"><hr /></div>

 <div id="footer">

 <div id="footer-text">

-Last updated 2013-08-20 08:40:27 PDT

+Last updated 2013-08-30 16:51:59 PDT

 </div>

 </div>

 </body>