path: root/Documentation/git-for-each-ref.txt
diff options
authorHariom Verma <>2020-08-21 21:41:43 (GMT)
committerJunio C Hamano <>2020-08-28 20:52:50 (GMT)
commitb82445dc2789f2046831621e6be7b2af464af6e9 (patch)
tree4084f2747aeec3e596d43caef36ff2d352c8485b /Documentation/git-for-each-ref.txt
parent878e727637ec5815ccb3301eb994a54df95b21b8 (diff)
ref-filter: support different email formats
Currently, ref-filter only supports printing email with angle brackets. Let's add support for two more email options. - trim : for email without angle brackets. - localpart : for the part before the @ sign out of trimmed email Mentored-by: Christian Couder <> Mentored-by: Heba Waly <> Signed-off-by: Hariom Verma <> Signed-off-by: Junio C Hamano <>
Diffstat (limited to 'Documentation/git-for-each-ref.txt')
1 files changed, 4 insertions, 1 deletions
diff --git a/Documentation/git-for-each-ref.txt b/Documentation/git-for-each-ref.txt
index 2ea71c5..e6ce8af 100644
--- a/Documentation/git-for-each-ref.txt
+++ b/Documentation/git-for-each-ref.txt
@@ -230,7 +230,10 @@ These are intended for working on a mix of annotated and lightweight tags.
Fields that have name-email-date tuple as its value (`author`,
`committer`, and `tagger`) can be suffixed with `name`, `email`,
-and `date` to extract the named component.
+and `date` to extract the named component. For email fields (`authoremail`,
+`committeremail` and `taggeremail`), `:trim` can be appended to get the email
+without angle brackets, and `:localpart` to get the part before the `@` symbol
+out of the trimmed email.
The message in a commit or a tag object is `contents`, from which
`contents:<part>` can be used to extract various parts out of: