diff options
| author | Junio C Hamano <junio@hera.kernel.org> | 2008-07-06 05:20:31 +0000 |
|---|---|---|
| committer | Junio C Hamano <junio@hera.kernel.org> | 2008-07-06 05:20:31 +0000 |
| commit | ba4b9286c25f18c7ebbb809ee5732a7810377ab6 (patch) | |
| tree | 390507328a7564b65dc803683c34235700b97409 /git-show-ref.html | |
| parent | 05bf9c54a827e48b2b576488f5170a3490b5180e (diff) | |
| download | git-htmldocs-ba4b9286c25f18c7ebbb809ee5732a7810377ab6.tar.gz | |
Autogenerated HTML docs for v1.5.6.2-212-g08b5
Diffstat (limited to 'git-show-ref.html')
| -rw-r--r-- | git-show-ref.html | 150 |
1 files changed, 99 insertions, 51 deletions
diff --git a/git-show-ref.html b/git-show-ref.html index dffd3eded..e33bf3631 100644 --- a/git-show-ref.html +++ b/git-show-ref.html @@ -3,7 +3,7 @@ <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
-<meta name="generator" content="AsciiDoc 7.0.2" />
+<meta name="generator" content="AsciiDoc 8.2.5" />
<style type="text/css">
/* Debug borders */
p, li, dt, dd, div, pre, h1, h2, h3, h4, h5, h6 {
@@ -16,8 +16,13 @@ body { margin: 1em 5% 1em 5%;
}
-a { color: blue; }
-a:visited { color: fuchsia; }
+a {
+ color: blue;
+ text-decoration: underline;
+}
+a:visited {
+ color: fuchsia;
+}
em {
font-style: italic;
@@ -39,13 +44,18 @@ h1, h2, h3, h4, h5, h6 { line-height: 1.3;
}
-h1 {
+h1, h2, h3 {
border-bottom: 2px solid silver;
}
h2 {
- border-bottom: 2px solid silver;
padding-top: 0.5em;
}
+h3 {
+ float: left;
+}
+h3 + * {
+ clear: left;
+}
div.sectionbody {
font-family: serif;
@@ -70,7 +80,7 @@ span#author { color: #527bbd;
font-family: sans-serif;
font-weight: bold;
- font-size: 1.2em;
+ font-size: 1.1em;
}
span#email {
}
@@ -139,6 +149,9 @@ div.sidebarblock > div.content { padding: 0.5em;
}
+div.listingblock {
+ margin-right: 0%;
+}
div.listingblock > div.content {
border: 1px solid silver;
background: #f4f4f4;
@@ -148,9 +161,13 @@ div.listingblock > div.content { div.quoteblock > div.content {
padding-left: 2.0em;
}
-div.quoteblock .attribution {
+
+div.attribution {
text-align: right;
}
+div.verseblock + div.attribution {
+ text-align: left;
+}
div.admonitionblock .icon {
vertical-align: top;
@@ -194,13 +211,12 @@ dd > *:first-child { ul, ol {
list-style-position: outside;
}
-ol.olist2 {
+div.olist2 ol {
list-style-type: lower-alpha;
}
div.tableblock > table {
- border-color: #527bbd;
- border-width: 3px;
+ border: 3px solid #527bbd;
}
thead {
font-family: sans-serif;
@@ -214,6 +230,9 @@ div.hlist { margin-top: 0.8em;
margin-bottom: 0.8em;
}
+div.hlist td {
+ padding-bottom: 5px;
+}
td.hlist1 {
vertical-align: top;
font-style: italic;
@@ -226,7 +245,33 @@ td.hlist2 { @media print {
div#footer-badges { display: none; }
}
-include::./stylesheets/xhtml11-manpage.css[]
+
+div#toctitle {
+ color: #527bbd;
+ font-family: sans-serif;
+ font-size: 1.1em;
+ font-weight: bold;
+ margin-top: 1.0em;
+ margin-bottom: 0.1em;
+}
+
+div.toclevel1, div.toclevel2, div.toclevel3, div.toclevel4 {
+ margin-top: 0;
+ margin-bottom: 0;
+}
+div.toclevel2 {
+ margin-left: 2em;
+ font-size: 0.9em;
+}
+div.toclevel3 {
+ margin-left: 4em;
+ font-size: 0.9em;
+}
+div.toclevel4 {
+ margin-left: 6em;
+ font-size: 0.9em;
+}
+include1::./stylesheets/xhtml11-manpage.css[]
/* Workarounds for IE6's broken and incomplete CSS2. */
div.sidebar-content {
@@ -255,6 +300,9 @@ div.exampleblock-content { border-left: 2px solid silver;
padding-left: 0.5em;
}
+
+/* IE6 sets dynamically generated links as visited. */
+div#toc a:visited { color: blue; }
</style>
<title>git-show-ref(1)</title>
</head>
@@ -277,20 +325,20 @@ git-show-ref(1) Manual Page [-s|--hash] [--abbrev] [--tags] [--heads] [--] <pattern>…
<em>git show-ref</em> --exclude-existing[=pattern]</div></div>
</div>
-<h2>DESCRIPTION</h2>
+<h2 id="_description">DESCRIPTION</h2>
<div class="sectionbody">
-<p>Displays references available in a local repository along with the associated
+<div class="para"><p>Displays references available in a local repository along with the associated
commit IDs. Results can be filtered using a pattern and tags can be
dereferenced into object IDs. Additionally, it can be used to test whether a
-particular ref exists.</p>
-<p>The --exclude-existing form is a filter that does the inverse, it shows the
-refs from stdin that don't exist in the local repository.</p>
-<p>Use of this utility is encouraged in favor of directly accessing files under
-in the <tt>.git</tt> directory.</p>
+particular ref exists.</p></div>
+<div class="para"><p>The --exclude-existing form is a filter that does the inverse, it shows the
+refs from stdin that don't exist in the local repository.</p></div>
+<div class="para"><p>Use of this utility is encouraged in favor of directly accessing files under
+in the <tt>.git</tt> directory.</p></div>
</div>
-<h2>OPTIONS</h2>
+<h2 id="_options">OPTIONS</h2>
<div class="sectionbody">
-<dl>
+<div class="vlist"><dl>
<dt>
-h
</dt>
@@ -381,7 +429,7 @@ in the <tt>.git</tt> directory.</p> </dt>
<dd>
<p>
- Make <tt>git-show-ref</tt> act as a filter that reads refs from stdin of the
+ Make <em>git-show-ref</em> act as a filter that reads refs from stdin of the
form "<sup>(?:<anything>\s)?<refname>(?:\</sup>{})?$" and performs the
following actions on each:
(1) strip "^{}" at the end of line if any;
@@ -399,11 +447,11 @@ in the <tt>.git</tt> directory.</p> Show references matching one or more patterns.
</p>
</dd>
-</dl>
+</dl></div>
</div>
-<h2>OUTPUT</h2>
+<h2 id="_output">OUTPUT</h2>
<div class="sectionbody">
-<p>The output is in the format: <em><SHA-1 ID></em> <em><space></em> <em><reference name></em>.</p>
+<div class="para"><p>The output is in the format: <em><SHA-1 ID></em> <em><space></em> <em><reference name></em>.</p></div>
<div class="listingblock">
<div class="content">
<pre><tt>$ git show-ref --head --dereference
@@ -416,7 +464,7 @@ in the <tt>.git</tt> directory.</p> 423325a2d24638ddcc82ce47be5e40be550f4507 refs/tags/v1.0rc4^{}
...</tt></pre>
</div></div>
-<p>When using --hash (and not --dereference) the output format is: <em><SHA-1 ID></em></p>
+<div class="para"><p>When using --hash (and not --dereference) the output format is: <em><SHA-1 ID></em></p></div>
<div class="listingblock">
<div class="content">
<pre><tt>$ git show-ref --heads --hash
@@ -426,62 +474,62 @@ in the <tt>.git</tt> directory.</p> ...</tt></pre>
</div></div>
</div>
-<h2>EXAMPLE</h2>
+<h2 id="_example">EXAMPLE</h2>
<div class="sectionbody">
-<p>To show all references called "master", whether tags or heads or anything
+<div class="para"><p>To show all references called "master", whether tags or heads or anything
else, and regardless of how deep in the reference naming hierarchy they are,
-use:</p>
+use:</p></div>
<div class="listingblock">
<div class="content">
<pre><tt> git show-ref master</tt></pre>
</div></div>
-<p>This will show "refs/heads/master" but also "refs/remote/other-repo/master",
-if such references exists.</p>
-<p>When using the <em>--verify</em> flag, the command requires an exact path:</p>
+<div class="para"><p>This will show "refs/heads/master" but also "refs/remote/other-repo/master",
+if such references exists.</p></div>
+<div class="para"><p>When using the <em>--verify</em> flag, the command requires an exact path:</p></div>
<div class="listingblock">
<div class="content">
<pre><tt> git show-ref --verify refs/heads/master</tt></pre>
</div></div>
-<p>will only match the exact branch called "master".</p>
-<p>If nothing matches, <tt>git-show-ref</tt> will return an error code of 1,
-and in the case of verification, it will show an error message.</p>
-<p>For scripting, you can ask it to be quiet with the "--quiet" flag, which
-allows you to do things like</p>
+<div class="para"><p>will only match the exact branch called "master".</p></div>
+<div class="para"><p>If nothing matches, <em>git-show-ref</em> will return an error code of 1,
+and in the case of verification, it will show an error message.</p></div>
+<div class="para"><p>For scripting, you can ask it to be quiet with the "--quiet" flag, which
+allows you to do things like</p></div>
<div class="listingblock">
<div class="content">
<pre><tt> git show-ref --quiet --verify -- "refs/heads/$headname" ||
echo "$headname is not a valid branch"</tt></pre>
</div></div>
-<p>to check whether a particular branch exists or not (notice how we don't
+<div class="para"><p>to check whether a particular branch exists or not (notice how we don't
actually want to show any results, and we want to use the full refname for it
-in order to not trigger the problem with ambiguous partial matches).</p>
-<p>To show only tags, or only proper branch heads, use "--tags" and/or "--heads"
+in order to not trigger the problem with ambiguous partial matches).</p></div>
+<div class="para"><p>To show only tags, or only proper branch heads, use "--tags" and/or "--heads"
respectively (using both means that it shows tags and heads, but not other
-random references under the refs/ subdirectory).</p>
-<p>To do automatic tag object dereferencing, use the "-d" or "--dereference"
-flag, so you can do</p>
+random references under the refs/ subdirectory).</p></div>
+<div class="para"><p>To do automatic tag object dereferencing, use the "-d" or "--dereference"
+flag, so you can do</p></div>
<div class="listingblock">
<div class="content">
<pre><tt> git show-ref --tags --dereference</tt></pre>
</div></div>
-<p>to get a listing of all tags together with what they dereference.</p>
+<div class="para"><p>to get a listing of all tags together with what they dereference.</p></div>
</div>
-<h2>SEE ALSO</h2>
+<h2 id="_see_also">SEE ALSO</h2>
<div class="sectionbody">
-<p><a href="git-ls-remote.html">git-ls-remote(1)</a></p>
+<div class="para"><p><a href="git-ls-remote.html">git-ls-remote(1)</a></p></div>
</div>
-<h2>AUTHORS</h2>
+<h2 id="_authors">AUTHORS</h2>
<div class="sectionbody">
-<p>Written by Linus Torvalds <torvalds@osdl.org>.
-Man page by Jonas Fonseca <fonseca@diku.dk>.</p>
+<div class="para"><p>Written by Linus Torvalds <torvalds@osdl.org>.
+Man page by Jonas Fonseca <fonseca@diku.dk>.</p></div>
</div>
-<h2>GIT</h2>
+<h2 id="_git">GIT</h2>
<div class="sectionbody">
-<p>Part of the <a href="git.html">git(1)</a> suite</p>
+<div class="para"><p>Part of the <a href="git.html">git(1)</a> suite</p></div>
</div>
<div id="footer">
<div id="footer-text">
-Last updated 02-Jul-2008 03:02:03 UTC
+Last updated 2008-07-06 05:17:03 UTC
</div>
</div>
</body>
|