| blob | 5822a3c046c6c166ffe19910c0497b3768700816 |
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-for-each-ref(1) Manual Page
407 </h1>
410 <p>git-for-each-ref -
411 Output information on each ref
412 </p>
413 </div>
414 </div>
418 <div class="verseblock-content"><em>git for-each-ref</em> [--count=<count>] [--shell|--perl|--python|--tcl]
421 </div></div>
422 </div>
425 <div class="paragraph"><p>Iterate over all refs that match <tt><pattern></tt> and show them
429 can optionally be quoted as string literals in the specified
430 host language allowing their direct evaluation in that language.</p></div>
431 </div>
437 </dt>
438 <dd>
439 <p>
440 By default the command shows all refs that match
442 that many refs.
443 </p>
444 </dd>
447 </dt>
448 <dd>
449 <p>
451 descending order of the value. When unspecified,
453 multiple times, in which case the last key becomes the primary
454 key.
455 </p>
456 </dd>
459 </dt>
460 <dd>
461 <p>
465 at a tag object, the value for the field in the object
466 tag refers is used. When unspecified, defaults to
469 are hex digits interpolates to character with hex code
472 </p>
473 </dd>
476 </dt>
477 <dd>
478 <p>
479 If one or more patterns are given, only refs are shown that
480 match against at least one pattern, either using fnmatch(3) or
481 literally, in the latter case matching completely or from the
482 beginning up to a slash.
483 </p>
484 </dd>
486 --shell
487 </dt>
489 --perl
490 </dt>
492 --python
493 </dt>
495 --tcl
496 </dt>
497 <dd>
498 <p>
500 placeholders are quoted as string literals suitable for
501 the specified host language. This is meant to produce
502 a scriptlet that can directly be `eval`ed.
503 </p>
504 </dd>
505 </dl></div>
506 </div>
510 be used to interpolate into the resulting output, or as sort
511 keys.</p></div>
515 refname
516 </dt>
517 <dd>
518 <p>
519 The name of the ref (the part after $GIT_DIR/).
521 The option core.warnAmbiguousRefs is used to select the strict
522 abbreviation mode.
523 </p>
524 </dd>
526 objecttype
527 </dt>
528 <dd>
529 <p>
531 </p>
532 </dd>
534 objectsize
535 </dt>
536 <dd>
537 <p>
539 </p>
540 </dd>
542 objectname
543 </dt>
544 <dd>
545 <p>
546 The object name (aka SHA-1).
548 </p>
549 </dd>
551 upstream
552 </dt>
553 <dd>
554 <p>
558 </p>
559 </dd>
560 </dl></div>
562 field names (<tt>tree</tt>, <tt>parent</tt>, <tt>object</tt>, <tt>type</tt>, and <tt>tag</tt>) can
563 be used to specify the value in the header field.</p></div>
572 All other fields are used to sort in their byte-value order.</p></div>
574 the object referred by the ref does not cause an error. It
575 returns an empty string instead.</p></div>
576 <div class="paragraph"><p>As a special case for the date-type fields, you may specify a format for
577 the date by adding one of <tt>:default</tt>, <tt>:relative</tt>, <tt>:short</tt>, <tt>:local</tt>,
580 </div>
587 <pre><tt>#!/bin/sh
589 git for-each-ref --count=3 --sort='-*authordate' \
590 --format='From: %(*authorname) %(*authoremail)
591 Subject: %(*subject)
592 Date: %(*authordate)
593 Ref: %(*refname)
595 %(*body)
596 ' 'refs/tags'</tt></pre>
597 </div></div>
599 demonstrating the use of --shell. List the prefixes of all heads:</p></div>
602 <pre><tt>#!/bin/sh
605 while read entry
606 do
607 eval "$entry"
608 echo `dirname $ref`
609 done</tt></pre>
610 </div></div>
612 may be an entire script:</p></div>
615 <pre><tt>#!/bin/sh
617 fmt='
618 r=%(refname)
619 t=%(*objecttype)
620 T=${r#refs/tags/}
622 o=%(*objectname)
623 n=%(*authorname)
624 e=%(*authoremail)
625 s=%(*subject)
626 d=%(*authordate)
627 b=%(*body)
629 kind=Tag
630 if test "z$t" = z
631 then
632 # could be a lightweight tag
633 t=%(objecttype)
635 o=%(objectname)
636 n=%(authorname)
637 e=%(authoremail)
638 s=%(subject)
639 d=%(authordate)
640 b=%(body)
641 fi
642 echo "$kind $T points at a $t object $o"
643 if test "z$t" = zcommit
644 then
645 echo "The commit was authored by $n $e
646 at $d, and titled
648 $s
650 Its message reads as:
651 "
653 echo
654 fi
655 '
658 --sort='*objecttype' \
659 --sort=-taggerdate \
660 refs/tags`
662 </div></div>
663 </div>
666 <div class="paragraph"><p>Written by Junio C Hamano <<a href="mailto:gitster@pobox.com">gitster@pobox.com</a>>.</p></div>
667 </div>
670 <div class="paragraph"><p>Documentation by Junio C Hamano and the git-list <<a href="mailto:git@vger.kernel.org">git@vger.kernel.org</a>>.</p></div>
671 </div>
675 </div>
679 </div>
680 </div>
681 </body>
682 </html>