From: Jakub Narebski <jnareb@gmail.com>
Date: Sat, 28 Oct 2006 17:30:05 +0000 (+0200)
Subject: Documentation: Update information about <format> in git-for-each-ref
X-Git-Tag: v1.4.4-rc1~56
X-Git-Url: http://git.tremily.us/?a=commitdiff_plain;h=ba7545adab83e6bea43353937eabb467bcb7d4f7;p=git.git

Documentation: Update information about <format> in git-for-each-ref

Update information about value of <format> used when it is left
unspecified.  Add information about `%%` and `%xx` interpolation
(URL encoding).

Signed-off-by: Jakub Narebski <jnareb@gmail.com>
Signed-off-by: Junio C Hamano <junkio@cox.net>
---

diff --git a/Documentation/git-for-each-ref.txt b/Documentation/git-for-each-ref.txt
index d5fdcef8d..4af1ebf5d 100644
--- a/Documentation/git-for-each-ref.txt
+++ b/Documentation/git-for-each-ref.txt
@@ -38,7 +38,11 @@ OPTIONS
 	is prefixed with an asterisk (`*`) and the ref points
 	at a tag object, the value for the field in the object
 	tag refers is used.  When unspecified, defaults to
-	`%(refname)`.
+	`%(objectname) SPC %(objecttype) TAB %(refname)`.
+	It also interpolates `%%` to `%`, and `%xx` where `xx`
+	are hex digits interpolates to character with hex code
+	`xx`; for example `%00` interpolates to `\0` (NUL),
+	`%09` to `\t` (TAB) and `%0a` to `\n` (LF).
 
 <pattern>::
 	If given, the name of the ref is matched against this