Merge branch 'maint'

[git.git] / Documentation / git-for-each-ref.txt

diff --git a/Documentation/git-for-each-ref.txt b/Documentation/git-for-each-ref.txt
index da52eba7b3619667537c1df3c58a927010f1c8ab..f1f90cca62f61327a13b5ab41862596ca24a9b8f 100644 (file)
--- a/Documentation/git-for-each-ref.txt
+++ b/Documentation/git-for-each-ref.txt
@@ -7,7 +7,10 @@ git-for-each-ref - Output information on each ref
 
 SYNOPSIS
 --------
 
 SYNOPSIS
 --------

-'git-for-each-ref' [--count=<count>]\* [--shell|--perl|--python|--tcl] [--sort=<key>]\* [--format=<format>] [<pattern>]
+[verse]
+'git-for-each-ref' [--count=<count>]\*
+                   [--shell|--perl|--python|--tcl]
+                   [--sort=<key>]\* [--format=<format>] [<pattern>]

 
 DESCRIPTION
 -----------
 
 DESCRIPTION
 -----------


@@ -66,7 +69,7 @@ keys.
 For all objects, the following names can be used:
 
 refname::
 For all objects, the following names can be used:
 
 refname::

-       The name of the ref (the part after $GIT_DIR/refs/).
+       The name of the ref (the part after $GIT_DIR/).

 
 objecttype::
        The type of the object (`blob`, `tree`, `commit`, `tag`).
 
 objecttype::
        The type of the object (`blob`, `tree`, `commit`, `tag`).


@@ -97,6 +100,11 @@ In any case, a field name that refers to a field inapplicable to
 the object referred by the ref does not cause an error.  It
 returns an empty string instead.
 
 the object referred by the ref does not cause an error.  It
 returns an empty string instead.
 

+As a special case for the date-type fields, you may specify a format for
+the date by adding one of `:default`, `:relative`, `:short`, `:local`,
+`:iso8601` or `:rfc2822` to the end of the fieldname; e.g.
+`%(taggerdate:relative)`.
+

 
 EXAMPLES
 --------
 
 EXAMPLES
 --------