git/list[1] front-page[2] threads[3] people[4] search[5] about
 

[PATCH v2] git-for-each-ref.txt: minor improvements

From
LWLea Wiemann <lewiemann@gmail.com>
Date
Jun 5, 2008, 13:38 UTC
Message-ID
<1212673114-15751-1-git-send-email-LeWiemann@gmail.com>
In-Reply-To
<1212664752-12160-1-git-send-email-LeWiemann@gmail.com>
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
Previous: Lea WiemannNext: Lea Wiemann
Message 2 of 6 in “git-for-each-ref.txt: fix description of <pattern>”
  1. git-for-each-ref.txt: fix description of <pattern>Lea Wiemann, Jun 5, 2008
  2. git-for-each-ref.txt: minor improvementsLea Wiemann, Jun 5, 2008
  3. git-for-each-ref.txt: minor improvementsLea Wiemann, Jun 5, 2008
  4. Junio C HamanoJun 5, 2008
  5. git-for-each-ref.txt: minor fixesLea Wiemann, Jun 5, 2008
  6. git-for-each-ref.txt: minor improvementsLea Wiemann, Jun 5, 2008

Read the whole thread, see it on lore, or plain text.

$ cat FOOTERMessages come from the public archive at lore.kernel.org/git, fetched every hour. The front page is chosen and written each morning by an AI editor and can be wrong; the threads themselves are the record. About and API. For agents: an MCP server at https://gitlist.dev/mcp, and any thread, story or person page as Markdown by adding .md to its URL (or sending Accept: text/markdown). Details in /llms.txt.