git-for-each-ref.txt: minor improvements
Rewrapped synopsis and removed wrong asterisk behind --count option; clarified --sort=<key> description for multiple keys; documented that for-each-ref supports not only glob patterns but also prefixes like "refs/heads" as patterns, and that multiple patterns can be given. Signed-off-by: Lea Wiemann <LeWiemann@gmail.com> Signed-off-by: Junio C Hamano <gitster@pobox.com>maint
parent
a83123deec
commit
c0f6dc9b20
|
@ -8,9 +8,8 @@ git-for-each-ref - Output information on each ref
|
||||||
SYNOPSIS
|
SYNOPSIS
|
||||||
--------
|
--------
|
||||||
[verse]
|
[verse]
|
||||||
'git-for-each-ref' [--count=<count>]\*
|
'git-for-each-ref' [--count=<count>] [--shell|--perl|--python|--tcl]
|
||||||
[--shell|--perl|--python|--tcl]
|
[--sort=<key>]\* [--format=<format>] [<pattern>...]
|
||||||
[--sort=<key>]\* [--format=<format>] [<pattern>]
|
|
||||||
|
|
||||||
DESCRIPTION
|
DESCRIPTION
|
||||||
-----------
|
-----------
|
||||||
|
@ -32,8 +31,9 @@ OPTIONS
|
||||||
<key>::
|
<key>::
|
||||||
A field name to sort on. Prefix `-` to sort in
|
A field name to sort on. Prefix `-` to sort in
|
||||||
descending order of the value. When unspecified,
|
descending order of the value. When unspecified,
|
||||||
`refname` is used. More than one sort keys can be
|
`refname` is used. You may use the --sort=<key> option
|
||||||
given.
|
multiple times, in which case the last key becomes the primary
|
||||||
|
key.
|
||||||
|
|
||||||
<format>::
|
<format>::
|
||||||
A string that interpolates `%(fieldname)` from the
|
A string that interpolates `%(fieldname)` from the
|
||||||
|
@ -48,9 +48,10 @@ OPTIONS
|
||||||
`%09` to `\t` (TAB) and `%0a` to `\n` (LF).
|
`%09` to `\t` (TAB) and `%0a` to `\n` (LF).
|
||||||
|
|
||||||
<pattern>::
|
<pattern>::
|
||||||
If given, the name of the ref is matched against this
|
If one or more patterns are given, only refs are shown that
|
||||||
using fnmatch(3). Refs that do not match the pattern
|
match againt at least one pattern, either using fnmatch(3) or
|
||||||
are not shown.
|
literally, in the latter case matching completely or from the
|
||||||
|
beginning up to a slash.
|
||||||
|
|
||||||
--shell, --perl, --python, --tcl::
|
--shell, --perl, --python, --tcl::
|
||||||
If given, strings that substitute `%(fieldname)`
|
If given, strings that substitute `%(fieldname)`
|
||||||
|
|
Loading…
Reference in New Issue