diff options
author | Junio C Hamano <junio@kernel.org> | 2010-11-06 01:01:59 +0000 |
---|---|---|
committer | Junio C Hamano <junio@kernel.org> | 2010-11-06 01:01:59 +0000 |
commit | 68cf15a825368c926443c26a6516947fca3c1d39 (patch) | |
tree | a587c9a51372746ddc3cdb08108bb14fb94a0488 /git-show-ref.html | |
parent | 39c7a69d994a13cbd5594bf2f5e65a0f21cc9bb9 (diff) | |
download | git-htmldocs-68cf15a825368c926443c26a6516947fca3c1d39.tar.gz |
Autogenerated HTML docs for v1.7.3.2-161-g3089c
Diffstat (limited to 'git-show-ref.html')
-rw-r--r-- | git-show-ref.html | 234 |
1 files changed, 165 insertions, 69 deletions
diff --git a/git-show-ref.html b/git-show-ref.html index 62bebfb6f..7277374c1 100644 --- a/git-show-ref.html +++ b/git-show-ref.html @@ -3,7 +3,8 @@ <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 8.2.5" />
+<meta name="generator" content="AsciiDoc 8.4.5" />
+<title>git-show-ref(1)</title>
<style type="text/css">
/* Debug borders */
p, li, dt, dd, div, pre, h1, h2, h3, h4, h5, h6 {
@@ -26,10 +27,12 @@ a:visited { em {
font-style: italic;
+ color: navy;
}
strong {
font-weight: bold;
+ color: #083194;
}
tt {
@@ -71,6 +74,10 @@ p { margin-bottom: 0.5em;
}
+ul, ol, li > p {
+ margin-top: 0;
+}
+
pre {
padding: 0;
margin: 0;
@@ -84,7 +91,7 @@ span#author { }
span#email {
}
-span#revision {
+span#revnumber, span#revdate, span#revremark {
font-family: sans-serif;
}
@@ -104,11 +111,13 @@ div#footer-badges { padding-bottom: 0.5em;
}
-div#preamble,
+div#preamble {
+ margin-top: 1.5em;
+ margin-bottom: 1.5em;
+}
div.tableblock, div.imageblock, div.exampleblock, div.verseblock,
div.quoteblock, div.literalblock, div.listingblock, div.sidebarblock,
div.admonitionblock {
- margin-right: 10%;
margin-top: 1.5em;
margin-bottom: 1.5em;
}
@@ -123,6 +132,7 @@ div.content { /* Block element content. */ /* Block element titles. */
div.title, caption.title {
+ color: #527bbd;
font-family: sans-serif;
font-weight: bold;
text-align: left;
@@ -149,22 +159,33 @@ div.sidebarblock > div.content { padding: 0.5em;
}
-div.listingblock {
- margin-right: 0%;
-}
div.listingblock > div.content {
border: 1px solid silver;
background: #f4f4f4;
padding: 0.5em;
}
-div.quoteblock > div.content {
+div.quoteblock {
padding-left: 2.0em;
+ margin-right: 10%;
}
-
-div.attribution {
+div.quoteblock > div.attribution {
+ padding-top: 0.5em;
text-align: right;
}
+
+div.verseblock {
+ padding-left: 2.0em;
+ margin-right: 10%;
+}
+div.verseblock > div.content {
+ white-space: pre;
+}
+div.verseblock > div.attribution {
+ padding-top: 0.75em;
+ text-align: left;
+}
+/* DEPRECATED: Pre version 8.2.7 verse style literal block. */
div.verseblock + div.attribution {
text-align: left;
}
@@ -187,13 +208,9 @@ div.exampleblock > div.content { padding: 0.5em;
}
-div.verseblock div.content {
- white-space: pre;
-}
-
div.imageblock div.content { padding-left: 0; }
-div.imageblock img { border: 1px solid silver; }
span.image img { border-style: none; }
+a.image:visited { color: white; }
dl {
margin-top: 0.8em;
@@ -202,18 +219,38 @@ dl { dt {
margin-top: 0.5em;
margin-bottom: 0;
- font-style: italic;
+ font-style: normal;
+ color: navy;
}
dd > *:first-child {
- margin-top: 0;
+ margin-top: 0.1em;
}
ul, ol {
list-style-position: outside;
}
-div.olist2 ol {
+ol.arabic {
+ list-style-type: decimal;
+}
+ol.loweralpha {
list-style-type: lower-alpha;
}
+ol.upperalpha {
+ list-style-type: upper-alpha;
+}
+ol.lowerroman {
+ list-style-type: lower-roman;
+}
+ol.upperroman {
+ list-style-type: upper-roman;
+}
+
+div.compact ul, div.compact ol,
+div.compact p, div.compact p,
+div.compact div, div.compact div {
+ margin-top: 0.1em;
+ margin-bottom: 0.1em;
+}
div.tableblock > table {
border: 3px solid #527bbd;
@@ -225,22 +262,53 @@ thead { tfoot {
font-weight: bold;
}
+td > div.verse {
+ white-space: pre;
+}
+p.table {
+ margin-top: 0;
+}
+/* Because the table frame attribute is overriden by CSS in most browsers. */
+div.tableblock > table[frame="void"] {
+ border-style: none;
+}
+div.tableblock > table[frame="hsides"] {
+ border-left-style: none;
+ border-right-style: none;
+}
+div.tableblock > table[frame="vsides"] {
+ border-top-style: none;
+ border-bottom-style: none;
+}
+
-div.hlist {
+div.hdlist {
margin-top: 0.8em;
margin-bottom: 0.8em;
}
-div.hlist td {
- padding-bottom: 5px;
+div.hdlist tr {
+ padding-bottom: 15px;
}
-td.hlist1 {
+dt.hdlist1.strong, td.hdlist1.strong {
+ font-weight: bold;
+}
+td.hdlist1 {
vertical-align: top;
- font-style: italic;
+ font-style: normal;
padding-right: 0.8em;
+ color: navy;
}
-td.hlist2 {
+td.hdlist2 {
vertical-align: top;
}
+div.hdlist.compact tr {
+ margin: 0;
+ padding-bottom: 0;
+}
+
+.comment {
+ background: yellow;
+}
@media print {
div#footer-badges { display: none; }
@@ -271,7 +339,24 @@ div.toclevel4 { margin-left: 6em;
font-size: 0.9em;
}
-include1::./stylesheets/xhtml11-manpage.css[]
+/* Overrides for manpage documents */
+h1 {
+ padding-top: 0.5em;
+ padding-bottom: 0.5em;
+ border-top: 2px solid silver;
+ border-bottom: 2px solid silver;
+}
+h2 {
+ border-style: none;
+}
+div.sectionbody {
+ margin-left: 5%;
+}
+
+@media print {
+ div#toc { display: none; }
+}
+
/* Workarounds for IE6's broken and incomplete CSS2. */
div.sidebar-content {
@@ -280,6 +365,7 @@ div.sidebar-content { padding: 0.5em;
}
div.sidebar-title, div.image-title {
+ color: #527bbd;
font-family: sans-serif;
font-weight: bold;
margin-top: 0.0em;
@@ -292,8 +378,17 @@ div.listingblock div.content { padding: 0.5em;
}
-div.quoteblock-content {
- padding-left: 2.0em;
+div.quoteblock-attribution {
+ padding-top: 0.5em;
+ text-align: right;
+}
+
+div.verseblock-content {
+ white-space: pre;
+}
+div.verseblock-attribution {
+ padding-top: 0.75em;
+ text-align: left;
}
div.exampleblock-content {
@@ -304,7 +399,6 @@ div.exampleblock-content { /* IE6 sets dynamically generated links as visited. */
div#toc a:visited { color: blue; }
</style>
-<title>git-show-ref(1)</title>
</head>
<body>
<div id="header">
@@ -318,29 +412,31 @@ git-show-ref(1) Manual Page </p>
</div>
</div>
-<h2>SYNOPSIS</h2>
+<h2 id="_synopsis">SYNOPSIS</h2>
<div class="sectionbody">
<div class="verseblock">
-<div class="content"><em>git show-ref</em> [-q|--quiet] [--verify] [--head] [-d|--dereference]
+<div class="verseblock-content"><em>git show-ref</em> [-q|--quiet] [--verify] [--head] [-d|--dereference]
[-s|--hash[=<n>]] [--abbrev[=<n>]] [--tags]
[--heads] [--] [<pattern>…]
-<em>git show-ref</em> --exclude-existing[=<pattern>] < ref-list</div></div>
+<em>git show-ref</em> --exclude-existing[=<pattern>] < ref-list</div>
+<div class="verseblock-attribution">
+</div></div>
</div>
<h2 id="_description">DESCRIPTION</h2>
<div class="sectionbody">
-<div class="para"><p>Displays references available in a local repository along with the associated
+<div class="paragraph"><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></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
+<div class="paragraph"><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="paragraph"><p>Use of this utility is encouraged in favor of directly accessing files under
the <tt>.git</tt> directory.</p></div>
</div>
<h2 id="_options">OPTIONS</h2>
<div class="sectionbody">
-<div class="vlist"><dl>
-<dt>
+<div class="dlist"><dl>
+<dt class="hdlist1">
--head
</dt>
<dd>
@@ -348,10 +444,10 @@ the <tt>.git</tt> directory.</p></div> Show the HEAD reference.
</p>
</dd>
-<dt>
+<dt class="hdlist1">
--tags
</dt>
-<dt>
+<dt class="hdlist1">
--heads
</dt>
<dd>
@@ -361,10 +457,10 @@ the <tt>.git</tt> directory.</p></div> in "refs/heads" and "refs/tags" are displayed.
</p>
</dd>
-<dt>
+<dt class="hdlist1">
-d
</dt>
-<dt>
+<dt class="hdlist1">
--dereference
</dt>
<dd>
@@ -373,10 +469,10 @@ the <tt>.git</tt> directory.</p></div> appended.
</p>
</dd>
-<dt>
+<dt class="hdlist1">
-s
</dt>
-<dt>
+<dt class="hdlist1">
--hash[=<n>]
</dt>
<dd>
@@ -385,7 +481,7 @@ the <tt>.git</tt> directory.</p></div> --dereference the dereferenced tag will still be shown after the SHA1.
</p>
</dd>
-<dt>
+<dt class="hdlist1">
--verify
</dt>
<dd>
@@ -395,7 +491,7 @@ the <tt>.git</tt> directory.</p></div> message if <em>--quiet</em> was not specified.
</p>
</dd>
-<dt>
+<dt class="hdlist1">
--abbrev[=<n>]
</dt>
<dd>
@@ -404,10 +500,10 @@ the <tt>.git</tt> directory.</p></div> not have to say <tt>--hash --abbrev</tt>; <tt>--hash=n</tt> would do.
</p>
</dd>
-<dt>
+<dt class="hdlist1">
-q
</dt>
-<dt>
+<dt class="hdlist1">
--quiet
</dt>
<dd>
@@ -416,22 +512,22 @@ the <tt>.git</tt> directory.</p></div> can be used to silently check if a reference exists.
</p>
</dd>
-<dt>
+<dt class="hdlist1">
--exclude-existing[=<pattern>]
</dt>
<dd>
<p>
Make <em>git show-ref</em> act as a filter that reads refs from stdin of the
- form "^(?:<anything>\s)?<refname>(?:\^{})?$"
+ form "<sup>(?:<anything>\s)?<refname>(?:\^{})?$"
and performs the following actions on each:
- (1) strip "^{}" at the end of line if any;
+ (1) strip "</sup>{}" at the end of line if any;
(2) ignore if pattern is provided and does not head-match refname;
(3) warn if refname is not a well-formed refname and skip;
(4) ignore if refname is a ref that exists in the local repository;
(5) otherwise output the line.
</p>
</dd>
-<dt>
+<dt class="hdlist1">
<pattern>…
</dt>
<dd>
@@ -447,7 +543,7 @@ the <tt>.git</tt> directory.</p></div> </div>
<h2 id="_output">OUTPUT</h2>
<div class="sectionbody">
-<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="paragraph"><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
@@ -460,7 +556,7 @@ the <tt>.git</tt> directory.</p></div> 423325a2d24638ddcc82ce47be5e40be550f4507 refs/tags/v1.0rc4^{}
...</tt></pre>
</div></div>
-<div class="para"><p>When using --hash (and not --dereference) the output format is: <em><SHA-1 ID></em></p></div>
+<div class="paragraph"><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
@@ -472,66 +568,66 @@ the <tt>.git</tt> directory.</p></div> </div>
<h2 id="_example">EXAMPLE</h2>
<div class="sectionbody">
-<div class="para"><p>To show all references called "master", whether tags or heads or anything
+<div class="paragraph"><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></div>
<div class="listingblock">
<div class="content">
<pre><tt> git show-ref master</tt></pre>
</div></div>
-<div class="para"><p>This will show "refs/heads/master" but also "refs/remote/other-repo/master",
+<div class="paragraph"><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="paragraph"><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>
-<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,
+<div class="paragraph"><p>will only match the exact branch called "master".</p></div>
+<div class="paragraph"><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
+<div class="paragraph"><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>
-<div class="para"><p>to check whether a particular branch exists or not (notice how we don't
+<div class="paragraph"><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></div>
-<div class="para"><p>To show only tags, or only proper branch heads, use "--tags" and/or "--heads"
+<div class="paragraph"><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></div>
-<div class="para"><p>To do automatic tag object dereferencing, use the "-d" or "--dereference"
+<div class="paragraph"><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>
-<div class="para"><p>to get a listing of all tags together with what they dereference.</p></div>
+<div class="paragraph"><p>to get a listing of all tags together with what they dereference.</p></div>
</div>
<h2 id="_files">FILES</h2>
<div class="sectionbody">
-<div class="para"><p><tt>.git/refs/*</tt>, <tt>.git/packed-refs</tt></p></div>
+<div class="paragraph"><p><tt>.git/refs/*</tt>, <tt>.git/packed-refs</tt></p></div>
</div>
<h2 id="_see_also">SEE ALSO</h2>
<div class="sectionbody">
-<div class="para"><p><a href="git-ls-remote.html">git-ls-remote(1)</a>,
+<div class="paragraph"><p><a href="git-ls-remote.html">git-ls-remote(1)</a>,
<a href="git-update-ref.html">git-update-ref(1)</a>,
<a href="gitrepository-layout.html">gitrepository-layout(5)</a></p></div>
</div>
<h2 id="_authors">AUTHORS</h2>
<div class="sectionbody">
-<div class="para"><p>Written by Linus Torvalds <torvalds@osdl.org>.
-Man page by Jonas Fonseca <fonseca@diku.dk>.</p></div>
+<div class="paragraph"><p>Written by Linus Torvalds <<a href="mailto:torvalds@osdl.org">torvalds@osdl.org</a>>.
+Man page by Jonas Fonseca <<a href="mailto:fonseca@diku.dk">fonseca@diku.dk</a>>.</p></div>
</div>
<h2 id="_git">GIT</h2>
<div class="sectionbody">
-<div class="para"><p>Part of the <a href="git.html">git(1)</a> suite</p></div>
+<div class="paragraph"><p>Part of the <a href="git.html">git(1)</a> suite</p></div>
</div>
<div id="footer">
<div id="footer-text">
-Last updated 2010-10-19 23:50:45 UTC
+Last updated 2010-11-06 00:41:57 UTC
</div>
</div>
</body>
|