1 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN"
\r
2 "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
\r
3 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en">
\r
5 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
\r
6 <meta name="generator" content="AsciiDoc 7.0.2" />
\r
7 <style type="text/css">
\r
9 p, li, dt, dd, div, pre, h1, h2, h3, h4, h5, h6 {
\r
11 border: 1px solid red;
\r
16 margin: 1em 5% 1em 5%;
\r
20 a:visited { color: fuchsia; }
\r
34 h1, h2, h3, h4, h5, h6 {
\r
36 font-family: sans-serif;
\r
38 margin-bottom: 0.5em;
\r
43 border-bottom: 2px solid silver;
\r
46 border-bottom: 2px solid silver;
\r
56 border: 1px solid silver;
\r
61 margin-bottom: 0.5em;
\r
71 font-family: sans-serif;
\r
78 font-family: sans-serif;
\r
82 font-family: sans-serif;
\r
84 border-top: 2px solid silver;
\r
90 padding-bottom: 0.5em;
\r
94 padding-bottom: 0.5em;
\r
98 div.tableblock, div.imageblock, div.exampleblock, div.verseblock,
\r
99 div.quoteblock, div.literalblock, div.listingblock, div.sidebarblock,
\r
100 div.admonitionblock {
\r
103 margin-bottom: 1.5em;
\r
105 div.admonitionblock {
\r
107 margin-bottom: 2.5em;
\r
110 div.content { /* Block element content. */
\r
114 /* Block element titles. */
\r
115 div.title, caption.title {
\r
116 font-family: sans-serif;
\r
120 margin-bottom: 0.5em;
\r
126 td div.title:first-child {
\r
129 div.content div.title:first-child {
\r
132 div.content + div.title {
\r
136 div.sidebarblock > div.content {
\r
137 background: #ffffee;
\r
138 border: 1px solid silver;
\r
142 div.listingblock > div.content {
\r
143 border: 1px solid silver;
\r
144 background: #f4f4f4;
\r
148 div.quoteblock > div.content {
\r
149 padding-left: 2.0em;
\r
151 div.quoteblock .attribution {
\r
155 div.admonitionblock .icon {
\r
156 vertical-align: top;
\r
159 text-decoration: underline;
\r
161 padding-right: 0.5em;
\r
163 div.admonitionblock td.content {
\r
164 padding-left: 0.5em;
\r
165 border-left: 2px solid silver;
\r
168 div.exampleblock > div.content {
\r
169 border-left: 2px solid silver;
\r
173 div.verseblock div.content {
\r
177 div.imageblock div.content { padding-left: 0; }
\r
178 div.imageblock img { border: 1px solid silver; }
\r
179 span.image img { border-style: none; }
\r
183 margin-bottom: 0.8em;
\r
188 font-style: italic;
\r
190 dd > *:first-child {
\r
195 list-style-position: outside;
\r
198 list-style-type: lower-alpha;
\r
201 div.tableblock > table {
\r
202 border-color: #527bbd;
\r
206 font-family: sans-serif;
\r
215 margin-bottom: 0.8em;
\r
218 vertical-align: top;
\r
219 font-style: italic;
\r
220 padding-right: 0.8em;
\r
223 vertical-align: top;
\r
227 div#footer-badges { display: none; }
\r
229 include::./stylesheets/xhtml11-manpage.css[]
\r
230 /* Workarounds for IE6's broken and incomplete CSS2. */
\r
232 div.sidebar-content {
\r
233 background: #ffffee;
\r
234 border: 1px solid silver;
\r
237 div.sidebar-title, div.image-title {
\r
238 font-family: sans-serif;
\r
241 margin-bottom: 0.5em;
\r
244 div.listingblock div.content {
\r
245 border: 1px solid silver;
\r
246 background: #f4f4f4;
\r
250 div.quoteblock-content {
\r
251 padding-left: 2.0em;
\r
254 div.exampleblock-content {
\r
255 border-left: 2px solid silver;
\r
256 padding-left: 0.5em;
\r
259 <title>git-describe(1)</title>
\r
264 git-describe(1) Manual Page
\r
267 <div class="sectionbody">
\r
269 Show the most recent tag that is reachable from a commit
\r
274 <div class="sectionbody">
\r
275 <p><em>git-describe</em> [--all] [--tags] [--abbrev=<n>] <committish>…</p>
\r
277 <h2>DESCRIPTION</h2>
\r
278 <div class="sectionbody">
\r
279 <p>The command finds the most recent tag that is reachable from a
\r
280 commit, and if the commit itself is pointed at by the tag, shows
\r
281 the tag. Otherwise, it suffixes the tag name with abbreviated
\r
282 object name of the commit.</p>
\r
285 <div class="sectionbody">
\r
292 The object name of the comittish.
\r
300 Instead of using only the annotated tags, use any ref
\r
301 found in <tt>.git/refs/</tt>.
\r
309 Instead of using only the annotated tags, use any tag
\r
310 found in <tt>.git/refs/tags</tt>.
\r
318 Instead of using the default 8 hexadecimal digits as the
\r
319 abbreviated object name, use <n> digits.
\r
325 <div class="sectionbody">
\r
326 <p>With something like git.git current tree, I get:</p>
\r
327 <div class="literalblock">
\r
328 <div class="content">
\r
329 <pre><tt>[torvalds@g5 git]$ git-describe parent
\r
330 v1.0.4-g2414721b</tt></pre>
\r
332 <p>i.e. the current head of my "parent" branch is based on v1.0.4,
\r
333 but since it has a few commits on top of that, it has added the
\r
334 git hash of the thing to the end: "-g" + 8-char shorthand for
\r
335 the commit <tt>2414721b194453f058079d897d13c4e377f92dc6</tt>.</p>
\r
336 <p>Doing a "git-describe" on a tag-name will just show the tag name:</p>
\r
337 <div class="literalblock">
\r
338 <div class="content">
\r
339 <pre><tt>[torvalds@g5 git]$ git-describe v1.0.4
\r
342 <p>With --all, the command can use branch heads as references, so
\r
343 the output shows the reference path as well:</p>
\r
344 <div class="literalblock">
\r
345 <div class="content">
\r
346 <pre><tt>[torvalds@g5 git]$ git describe --all --abbrev=4 v1.0.5^2
\r
347 tags/v1.0.0-g975b</tt></pre>
\r
349 <div class="literalblock">
\r
350 <div class="content">
\r
351 <pre><tt>[torvalds@g5 git]$ git describe --all HEAD^
\r
352 heads/lt/describe-g975b</tt></pre>
\r
356 <div class="sectionbody">
\r
357 <p>Written by Linus Torvalds <torvalds@osdl.org>, but somewhat
\r
358 butchered by Junio C Hamano <junkio@cox.net></p>
\r
360 <h2>Documentation</h2>
\r
361 <div class="sectionbody">
\r
362 <p>Documentation by David Greaves, Junio C Hamano and the git-list <git@vger.kernel.org>.</p>
\r
365 <div class="sectionbody">
\r
366 <p>Part of the <a href="git.html">git(7)</a> suite</p>
\r
369 <div id="footer-text">
\r
370 Last updated 10-Mar-2006 00:31:24 UTC
\r