* [PATCH] git-for-each-ref.txt: fix description of <pattern>
@ 2008-06-05 11:19 Lea Wiemann
2008-06-05 13:38 ` [PATCH v2] git-for-each-ref.txt: minor improvements Lea Wiemann
0 siblings, 1 reply; 6+ messages in thread
From: Lea Wiemann @ 2008-06-05 11:19 UTC (permalink / raw)
To: git; +Cc: Lea Wiemann
git-for-each-ref supports not only glob patterns but also prefixes
like "refs/heads" as patterns. This documents it.
Signed-off-by: Lea Wiemann <LeWiemann@gmail.com>
---
Documentation/git-for-each-ref.txt | 6 +++---
1 files changed, 3 insertions(+), 3 deletions(-)
diff --git a/Documentation/git-for-each-ref.txt b/Documentation/git-for-each-ref.txt
index f1f90cc..a9633c6 100644
--- a/Documentation/git-for-each-ref.txt
+++ b/Documentation/git-for-each-ref.txt
@@ -48,9 +48,9 @@ OPTIONS
`%09` to `\t` (TAB) and `%0a` to `\n` (LF).
<pattern>::
- If given, the name of the ref is matched against this
- using fnmatch(3). Refs that do not match the pattern
- are not shown.
+ If given, only refs are shown that match againt the pattern
+ either using fnmatch(3) or literally, in the latter case up to
+ a slash or entirely.
--shell, --perl, --python, --tcl::
If given, strings that substitute `%(fieldname)`
--
1.5.6.rc1.9.g69bbf.dirty
^ permalink raw reply related [flat|nested] 6+ messages in thread
* [PATCH v2] git-for-each-ref.txt: minor improvements
2008-06-05 11:19 [PATCH] git-for-each-ref.txt: fix description of <pattern> Lea Wiemann
@ 2008-06-05 13:38 ` Lea Wiemann
2008-06-05 18:40 ` [PATCH v3] " Lea Wiemann
0 siblings, 1 reply; 6+ messages in thread
From: Lea Wiemann @ 2008-06-05 13:38 UTC (permalink / raw)
To: git; +Cc: Lea Wiemann, Lea Wiemann
From: Lea Wiemann <lewiemann@gmail.com>
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.
Signed-off-by: Lea Wiemann <LeWiemann@gmail.com>
---
Added more fixes/improvements since v1.
Documentation/git-for-each-ref.txt | 14 +++++++-------
1 files changed, 7 insertions(+), 7 deletions(-)
diff --git a/Documentation/git-for-each-ref.txt b/Documentation/git-for-each-ref.txt
index f1f90cc..4ffc65f 100644
--- a/Documentation/git-for-each-ref.txt
+++ b/Documentation/git-for-each-ref.txt
@@ -8,8 +8,7 @@ git-for-each-ref - Output information on each ref
SYNOPSIS
--------
[verse]
-'git-for-each-ref' [--count=<count>]\*
- [--shell|--perl|--python|--tcl]
+'git-for-each-ref' [--count=<count>] [--shell|--perl|--python|--tcl]
[--sort=<key>]\* [--format=<format>] [<pattern>]
DESCRIPTION
@@ -32,8 +31,9 @@ OPTIONS
<key>::
A field name to sort on. Prefix `-` to sort in
descending order of the value. When unspecified,
- `refname` is used. More than one sort keys can be
- given.
+ `refname` is used. You may use the --sort=<key> option
+ multiple times, in which case the last key becomes the primary
+ key.
<format>::
A string that interpolates `%(fieldname)` from the
@@ -48,9 +48,9 @@ OPTIONS
`%09` to `\t` (TAB) and `%0a` to `\n` (LF).
<pattern>::
- If given, the name of the ref is matched against this
- using fnmatch(3). Refs that do not match the pattern
- are not shown.
+ If given, only refs are shown that match againt the pattern
+ either using fnmatch(3) or literally, in the latter case up to
+ a slash or entirely.
--shell, --perl, --python, --tcl::
If given, strings that substitute `%(fieldname)`
--
1.5.6.rc1.9.g69bbf.dirty
^ permalink raw reply related [flat|nested] 6+ messages in thread* [PATCH v3] git-for-each-ref.txt: minor improvements
2008-06-05 13:38 ` [PATCH v2] git-for-each-ref.txt: minor improvements Lea Wiemann
@ 2008-06-05 18:40 ` Lea Wiemann
2008-06-05 18:58 ` Junio C Hamano
0 siblings, 1 reply; 6+ messages in thread
From: Lea Wiemann @ 2008-06-05 18:40 UTC (permalink / raw)
To: git; +Cc: Lea Wiemann, Lea Wiemann
From: Lea Wiemann <lewiemann@gmail.com>
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>
---
Changed since v2: Also document that multiple patterns can be given.
Documentation/git-for-each-ref.txt | 16 ++++++++--------
1 files changed, 8 insertions(+), 8 deletions(-)
diff --git a/Documentation/git-for-each-ref.txt b/Documentation/git-for-each-ref.txt
index f1f90cc..2ff4c2d 100644
--- a/Documentation/git-for-each-ref.txt
+++ b/Documentation/git-for-each-ref.txt
@@ -8,9 +8,8 @@ git-for-each-ref - Output information on each ref
SYNOPSIS
--------
[verse]
-'git-for-each-ref' [--count=<count>]\*
- [--shell|--perl|--python|--tcl]
- [--sort=<key>]\* [--format=<format>] [<pattern>]
+'git-for-each-ref' [--count=<count>] [--shell|--perl|--python|--tcl]
+ [--sort=<key>]\* [--format=<format>] [<pattern>...]
DESCRIPTION
-----------
@@ -32,8 +31,9 @@ OPTIONS
<key>::
A field name to sort on. Prefix `-` to sort in
descending order of the value. When unspecified,
- `refname` is used. More than one sort keys can be
- given.
+ `refname` is used. You may use the --sort=<key> option
+ multiple times, in which case the last key becomes the primary
+ key.
<format>::
A string that interpolates `%(fieldname)` from the
@@ -48,9 +48,9 @@ OPTIONS
`%09` to `\t` (TAB) and `%0a` to `\n` (LF).
<pattern>::
- If given, the name of the ref is matched against this
- using fnmatch(3). Refs that do not match the pattern
- are not shown.
+ If one or more patterns are given, only refs are shown that
+ match againt at least one pattern, either using fnmatch(3) or
+ literally, in the latter case up to a slash or entirely.
--shell, --perl, --python, --tcl::
If given, strings that substitute `%(fieldname)`
--
1.5.6.rc1.9.g69bbf.dirty
^ permalink raw reply related [flat|nested] 6+ messages in thread
* Re: [PATCH v3] git-for-each-ref.txt: minor improvements
2008-06-05 18:40 ` [PATCH v3] " Lea Wiemann
@ 2008-06-05 18:58 ` Junio C Hamano
2008-06-05 20:54 ` [PATCH] git-for-each-ref.txt: minor fixes Lea Wiemann
0 siblings, 1 reply; 6+ messages in thread
From: Junio C Hamano @ 2008-06-05 18:58 UTC (permalink / raw)
To: Lea Wiemann; +Cc: git, Lea Wiemann
Lea Wiemann <lewiemann@gmail.com> writes:
> <pattern>::
> - If given, the name of the ref is matched against this
> - using fnmatch(3). Refs that do not match the pattern
> - are not shown.
> + If one or more patterns are given, only refs are shown that
> + match againt at least one pattern, either using fnmatch(3) or
> + literally, in the latter case up to a slash or entirely.
Thanks. I suspect we might want to make it even more explicit that this
is "match from the beginning" unlike what git-show-ref does, but your
patch is an improvement even as-is.
^ permalink raw reply [flat|nested] 6+ messages in thread
* [PATCH] git-for-each-ref.txt: minor fixes
2008-06-05 18:58 ` Junio C Hamano
@ 2008-06-05 20:54 ` Lea Wiemann
2008-06-05 21:01 ` [PATCH v5] git-for-each-ref.txt: minor improvements Lea Wiemann
0 siblings, 1 reply; 6+ messages in thread
From: Lea Wiemann @ 2008-06-05 20:54 UTC (permalink / raw)
To: git; +Cc: Lea Wiemann, Lea Wiemann
From: Lea Wiemann <lewiemann@gmail.com>
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>
---
Junio C Hamano wrote:
> I suspect we might want to make it even more explicit that this
> is "match from the beginning"
Sure; see if you like this one (the only change since v3 is under
<pattern>) or v3 better.
Documentation/git-for-each-ref.txt | 17 +++++++++--------
1 files changed, 9 insertions(+), 8 deletions(-)
diff --git a/Documentation/git-for-each-ref.txt b/Documentation/git-for-each-ref.txt
index f1f90cc..87c8389 100644
--- a/Documentation/git-for-each-ref.txt
+++ b/Documentation/git-for-each-ref.txt
@@ -8,9 +8,8 @@ git-for-each-ref - Output information on each ref
SYNOPSIS
--------
[verse]
-'git-for-each-ref' [--count=<count>]\*
- [--shell|--perl|--python|--tcl]
- [--sort=<key>]\* [--format=<format>] [<pattern>]
+'git-for-each-ref' [--count=<count>] [--shell|--perl|--python|--tcl]
+ [--sort=<key>]\* [--format=<format>] [<pattern>...]
DESCRIPTION
-----------
@@ -32,8 +31,9 @@ OPTIONS
<key>::
A field name to sort on. Prefix `-` to sort in
descending order of the value. When unspecified,
- `refname` is used. More than one sort keys can be
- given.
+ `refname` is used. You may use the --sort=<key> option
+ multiple times, in which case the last key becomes the primary
+ key.
<format>::
A string that interpolates `%(fieldname)` from the
@@ -48,9 +48,10 @@ OPTIONS
`%09` to `\t` (TAB) and `%0a` to `\n` (LF).
<pattern>::
- If given, the name of the ref is matched against this
- using fnmatch(3). Refs that do not match the pattern
- are not shown.
+ If one or more patterns are given, only refs are shown that
+ match againt at least one pattern, either using fnmatch(3) or
+ literally, in the latter case matching completely or from the
+ beginning up to a slash.
--shell, --perl, --python, --tcl::
If given, strings that substitute `%(fieldname)`
--
1.5.6.rc1.9.g69bbf.dirty
^ permalink raw reply related [flat|nested] 6+ messages in thread
* [PATCH v5] git-for-each-ref.txt: minor improvements
2008-06-05 20:54 ` [PATCH] git-for-each-ref.txt: minor fixes Lea Wiemann
@ 2008-06-05 21:01 ` Lea Wiemann
0 siblings, 0 replies; 6+ messages in thread
From: Lea Wiemann @ 2008-06-05 21:01 UTC (permalink / raw)
To: git; +Cc: Lea Wiemann
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>
---
... and fixed the subject line. Sorry for spamming the list!
Documentation/git-for-each-ref.txt | 17 +++++++++--------
1 files changed, 9 insertions(+), 8 deletions(-)
diff --git a/Documentation/git-for-each-ref.txt b/Documentation/git-for-each-ref.txt
index f1f90cc..87c8389 100644
--- a/Documentation/git-for-each-ref.txt
+++ b/Documentation/git-for-each-ref.txt
@@ -8,9 +8,8 @@ git-for-each-ref - Output information on each ref
SYNOPSIS
--------
[verse]
-'git-for-each-ref' [--count=<count>]\*
- [--shell|--perl|--python|--tcl]
- [--sort=<key>]\* [--format=<format>] [<pattern>]
+'git-for-each-ref' [--count=<count>] [--shell|--perl|--python|--tcl]
+ [--sort=<key>]\* [--format=<format>] [<pattern>...]
DESCRIPTION
-----------
@@ -32,8 +31,9 @@ OPTIONS
<key>::
A field name to sort on. Prefix `-` to sort in
descending order of the value. When unspecified,
- `refname` is used. More than one sort keys can be
- given.
+ `refname` is used. You may use the --sort=<key> option
+ multiple times, in which case the last key becomes the primary
+ key.
<format>::
A string that interpolates `%(fieldname)` from the
@@ -48,9 +48,10 @@ OPTIONS
`%09` to `\t` (TAB) and `%0a` to `\n` (LF).
<pattern>::
- If given, the name of the ref is matched against this
- using fnmatch(3). Refs that do not match the pattern
- are not shown.
+ If one or more patterns are given, only refs are shown that
+ match againt at least one pattern, either using fnmatch(3) or
+ literally, in the latter case matching completely or from the
+ beginning up to a slash.
--shell, --perl, --python, --tcl::
If given, strings that substitute `%(fieldname)`
--
1.5.6.rc1.9.g69bbf.dirty
^ permalink raw reply related [flat|nested] 6+ messages in thread
end of thread, other threads:[~2008-06-05 21:02 UTC | newest]
Thread overview: 6+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2008-06-05 11:19 [PATCH] git-for-each-ref.txt: fix description of <pattern> Lea Wiemann
2008-06-05 13:38 ` [PATCH v2] git-for-each-ref.txt: minor improvements Lea Wiemann
2008-06-05 18:40 ` [PATCH v3] " Lea Wiemann
2008-06-05 18:58 ` Junio C Hamano
2008-06-05 20:54 ` [PATCH] git-for-each-ref.txt: minor fixes Lea Wiemann
2008-06-05 21:01 ` [PATCH v5] git-for-each-ref.txt: minor improvements Lea Wiemann
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).