| blob | 0ff2d5734eb946f60c8c516838366018b976bf04 |
4 <head>
9 /* Debug borders */
11 /*
12 border: 1px solid red;
13 */
14 }
16 body {
18 }
20 a {
23 }
26 }
28 em {
31 }
33 strong {
36 }
38 tt {
40 }
48 }
52 }
53 h2 {
55 }
56 h3 {
58 }
59 h3 + * {
61 }
66 }
68 hr {
70 }
72 p {
75 }
79 }
81 pre {
84 }
86 span#author {
91 }
92 span#email {
93 }
96 }
98 div#footer {
104 }
105 div#footer-text {
108 }
109 div#footer-badges {
112 }
114 div#preamble {
117 }
123 }
127 }
131 }
133 /* Block element titles. */
141 }
144 }
148 }
151 }
154 }
160 }
166 }
171 }
175 }
180 }
183 }
187 }
188 /* DEPRECATED: Pre version 8.2.7 verse style literal block. */
191 }
200 }
204 }
209 }
215 dl {
218 }
219 dt {
224 }
227 }
231 }
234 }
237 }
240 }
243 }
246 }
253 }
257 }
258 thead {
261 }
262 tfoot {
264 }
267 }
270 }
271 /* Because the table frame attribute is overriden by CSS in most browsers. */
274 }
278 }
282 }
288 }
291 }
294 }
300 }
303 }
307 }
311 }
315 }
317 div#toctitle {
324 }
329 }
333 }
337 }
341 }
342 /* Overrides for manpage documents */
343 h1 {
348 }
349 h2 {
351 }
354 }
358 }
360 /* Workarounds for IE6's broken and incomplete CSS2. */
366 }
373 }
379 }
384 }
388 }
392 }
397 }
399 /* IE6 sets dynamically generated links as visited. */
401 </style>
402 </head>
403 <body>
405 <h1>
406 git-describe(1) Manual Page
407 </h1>
410 <p>git-describe -
411 Show the most recent tag that is reachable from a commit
412 </p>
413 </div>
414 </div>
418 <div class="verseblock-content"><em>git describe</em> [--all] [--tags] [--contains] [--abbrev=<n>] <committish>…
419 <em>git describe</em> [--all] [--tags] [--contains] [--abbrev=<n>] --dirty[=<mark>]</div>
421 </div></div>
422 </div>
426 commit. If the tag points to the commit, then only the tag is
427 shown. Otherwise, it suffixes the tag name with the number of
428 additional commits on top of the tagged object and the
429 abbreviated object name of the most recent commit.</p></div>
431 annotated tags. For more information about creating annotated tags
433 </div>
439 </dt>
440 <dd>
441 <p>
442 Committish object names to describe.
443 </p>
444 </dd>
447 </dt>
448 <dd>
449 <p>
450 Describe the working tree.
452 default) if the working tree is dirty.
453 </p>
454 </dd>
456 --all
457 </dt>
458 <dd>
459 <p>
460 Instead of using only the annotated tags, use any ref
462 any known branch, remote-tracking branch, or lightweight tag.
463 </p>
464 </dd>
466 --tags
467 </dt>
468 <dd>
469 <p>
470 Instead of using only the annotated tags, use any tag
472 a lightweight (non-annotated) tag.
473 </p>
474 </dd>
476 --contains
477 </dt>
478 <dd>
479 <p>
480 Instead of finding the tag that predates the commit, find
481 the tag that comes after the commit, and thus contains it.
482 Automatically implies --tags.
483 </p>
484 </dd>
487 </dt>
488 <dd>
489 <p>
490 Instead of using the default 7 hexadecimal digits as the
493 will suppress long format, only showing the closest tag.
494 </p>
495 </dd>
498 </dt>
499 <dd>
500 <p>
501 Instead of considering only the 10 most recent tags as
502 candidates to describe the input committish consider
504 slightly longer but may produce a more accurate result.
506 </p>
507 </dd>
509 --exact-match
510 </dt>
511 <dd>
512 <p>
513 Only output exact matches (a tag directly references the
514 supplied commit). This is a synonym for --candidates=0.
515 </p>
516 </dd>
518 --debug
519 </dt>
520 <dd>
521 <p>
522 Verbosely display information about the searching strategy
523 being employed to standard error. The tag name will still
524 be printed to standard out.
525 </p>
526 </dd>
528 --long
529 </dt>
530 <dd>
531 <p>
532 Always output the long format (the tag, the number of commits
533 and the abbreviated commit name) even when it matches a tag.
534 This is useful when you want to see parts of the commit object name
535 in "describe" output, even when the commit in question happens to be
536 a tagged version. Instead of just emitting the tag name, it will
538 that points at object deadbee….).
539 </p>
540 </dd>
543 </dt>
544 <dd>
545 <p>
546 Only consider tags matching the given pattern (can be used to avoid
547 leaking private tags made from the repository).
548 </p>
549 </dd>
551 --always
552 </dt>
553 <dd>
554 <p>
555 Show uniquely abbreviated commit object as fallback.
556 </p>
557 </dd>
558 </dl></div>
559 </div>
565 <pre><tt>[torvalds@g5 git]$ git describe parent
567 </div></div>
569 but since it has a few commits on top of that,
570 describe has added the number of additional commits ("14") and
571 an abbreviated object name for the commit itself ("2414721")
572 at the end.</p></div>
574 of commits which would be displayed by "git log v1.0.4..parent".
578 a software depending on the SCM the software is managed with. This is useful
579 in an environment where people may use different SCMs.</p></div>
580 <div class="paragraph"><p>Doing a <em>git describe</em> on a tag-name will just show the tag name:</p></div>
585 </div></div>
587 the output shows the reference path as well:</p></div>
592 </div></div>
597 </div></div>
599 closest tagname without any suffix:</p></div>
604 </div></div>
606 longer than what Linus saw above when he ran these commands, as your
607 git repository may have new commits whose object names begin with
609 be sufficient to disambiguate these commits.</p></div>
610 </div>
613 <div class="paragraph"><p>For each committish supplied, <em>git describe</em> will first look for
614 a tag which tags exactly that commit. Annotated tags will always
615 be preferred over lightweight tags, and tags with newer dates will
616 always be preferred over tags with older dates. If an exact match
617 is found, its name will be output and searching will stop.</p></div>
619 through the commit history to locate an ancestor commit which
620 has been tagged. The ancestor’s tag will be output along with an
623 has the fewest commits different from the input committish will be
624 selected and output. Here fewest commits different is defined as
626 will be the smallest number of commits possible.</p></div>
627 </div>
631 </div>
635 </div>
636 </div>
637 </body>
638 </html>