1 <!DOCTYPE html PUBLIC
"-//W3C//DTD XHTML 1.1//EN"
2 "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
3 <html xmlns=
"http://www.w3.org/1999/xhtml" xml:
lang=
"en">
5 <meta http-equiv=
"Content-Type" content=
"text/html; charset=UTF-8" />
6 <meta name=
"generator" content=
"AsciiDoc 8.2.5" />
7 <style type=
"text/css">
9 p
, li
, dt
, dd
, div
, pre
, h1
, h2
, h3
, h4
, h5
, h6
{
11 border: 1px solid red;
16 margin: 1em 5% 1em 5%;
21 text-decoration: underline
;
39 h1
, h2
, h3
, h4
, h5
, h6
{
41 font-family: sans-serif
;
48 border-bottom: 2px solid silver
;
66 border: 1px solid silver
;
81 font-family: sans-serif
;
88 font-family: sans-serif
;
92 font-family: sans-serif
;
94 border-top: 2px solid silver
;
100 padding-bottom: 0.5em;
104 padding-bottom: 0.5em;
108 div
.tableblock
, div
.imageblock
, div
.exampleblock
, div
.verseblock
,
109 div
.quoteblock
, div
.literalblock
, div
.listingblock
, div
.sidebarblock
,
110 div
.admonitionblock
{
113 margin-bottom: 1.5em;
115 div
.admonitionblock
{
117 margin-bottom: 2.5em;
120 div
.content
{ /* Block element content. */
124 /* Block element titles. */
125 div
.title
, caption
.title
{
126 font-family: sans-serif
;
130 margin-bottom: 0.5em;
136 td div
.title:first-child
{
139 div
.content div
.title:first-child
{
142 div
.content
+ div
.title
{
146 div
.sidebarblock
> div
.content
{
148 border: 1px solid silver
;
155 div
.listingblock
> div
.content
{
156 border: 1px solid silver
;
161 div
.quoteblock
> div
.content
{
168 div
.verseblock
+ div
.attribution
{
172 div
.admonitionblock
.icon
{
176 text-decoration: underline
;
178 padding-right: 0.5em;
180 div
.admonitionblock td
.content
{
182 border-left: 2px solid silver
;
185 div
.exampleblock
> div
.content
{
186 border-left: 2px solid silver
;
190 div
.verseblock div
.content
{
194 div
.imageblock div
.content
{ padding-left: 0; }
195 div
.imageblock img
{ border: 1px solid silver
; }
196 span
.image img
{ border-style: none
; }
200 margin-bottom: 0.8em;
212 list-style-position: outside
;
215 list-style-type: lower-alpha
;
218 div
.tableblock
> table
{
219 border: 3px solid
#527bbd;
222 font-family: sans-serif
;
231 margin-bottom: 0.8em;
239 padding-right: 0.8em;
246 div#footer-badges
{ display: none
; }
251 font-family: sans-serif
;
255 margin-bottom: 0.1em;
258 div
.toclevel1
, div
.toclevel2
, div
.toclevel3
, div
.toclevel4
{
274 include1::./stylesheets
/xhtml11-manpage
.css
[]
275 /* Workarounds for IE6's broken and incomplete CSS2. */
277 div
.sidebar-content
{
279 border: 1px solid silver
;
282 div
.sidebar-title
, div
.image-title
{
283 font-family: sans-serif
;
286 margin-bottom: 0.5em;
289 div
.listingblock div
.content
{
290 border: 1px solid silver
;
295 div
.quoteblock-content
{
299 div
.exampleblock-content
{
300 border-left: 2px solid silver
;
304 /* IE6 sets dynamically generated links as visited. */
305 div#toc
a:visited
{ color: blue
; }
307 <title>git-name-rev(
1)
</title>
312 git-name-rev(
1) Manual Page
315 <div class=
"sectionbody">
317 Find symbolic names for given revs
322 <div class=
"sectionbody">
323 <div class=
"verseblock">
324 <div class=
"content"><em>git name-rev
</em> [--tags] [--refs=
<pattern
>]
325 ( --all | --stdin |
<committish
>… )
</div></div>
327 <h2 id=
"_description">DESCRIPTION
</h2>
328 <div class=
"sectionbody">
329 <div class=
"para"><p>Finds symbolic names suitable for human digestion for revisions given in any
330 format parsable by
<em>git rev-parse
</em>.
</p></div>
332 <h2 id=
"_options">OPTIONS
</h2>
333 <div class=
"sectionbody">
334 <div class=
"vlist"><dl>
340 Do not use branch names, but only tags to name the commits
344 --refs=
<pattern
>
348 Only use refs whose names match a given shell pattern.
356 List all commits reachable from all refs
364 Read from stdin, append
"(<rev_name>)" to all sha1's of nameable
365 commits, and pass to stdout
373 Instead of printing both the SHA-
1 and the name, print only
374 the name. If given with --tags the usual tag prefix of
375 "tags/" is also omitted from the name, matching the output
376 of
<tt>git-describe
</tt> more closely.
384 Die with error code !=
0 when a reference is undefined,
385 instead of printing
<tt>undefined
</tt>.
393 Show uniquely abbreviated commit object as fallback.
398 <h2 id=
"_example">EXAMPLE
</h2>
399 <div class=
"sectionbody">
400 <div class=
"para"><p>Given a commit, find out where it is relative to the local refs. Say somebody
401 wrote you about that fantastic commit
33db5f4d9027a10e477ccf054b2c1ab94f74c85a.
402 Of course, you look into the commit, but that only tells you what happened, but
403 not the context.
</p></div>
404 <div class=
"para"><p>Enter
<em>git name-rev
</em>:
</p></div>
405 <div class=
"listingblock">
406 <div class=
"content">
407 <pre><tt>% git name-rev
33db5f4d9027a10e477ccf054b2c1ab94f74c85a
408 33db5f4d9027a10e477ccf054b2c1ab94f74c85a tags/v0.99~
940</tt></pre>
410 <div class=
"para"><p>Now you are wiser, because you know that it happened
940 revisions before v0.99.
</p></div>
411 <div class=
"para"><p>Another nice thing you can do is:
</p></div>
412 <div class=
"listingblock">
413 <div class=
"content">
414 <pre><tt>% git log | git name-rev --stdin
</tt></pre>
417 <h2 id=
"_author">Author
</h2>
418 <div class=
"sectionbody">
419 <div class=
"para"><p>Written by Johannes Schindelin
<Johannes.Schindelin@gmx.de
></p></div>
421 <h2 id=
"_documentation">Documentation
</h2>
422 <div class=
"sectionbody">
423 <div class=
"para"><p>Documentation by Johannes Schindelin.
</p></div>
425 <h2 id=
"_git">GIT
</h2>
426 <div class=
"sectionbody">
427 <div class=
"para"><p>Part of the
<a href=
"git.html">git(
1)
</a> suite
</p></div>
430 <div id=
"footer-text">
431 Last updated
2010-
09-
18 23:
56:
50 UTC