summaryrefslogtreecommitdiffstats
path: root/man1/git-for-each-ref.1
diff options
context:
space:
mode:
Diffstat (limited to 'man1/git-for-each-ref.1')
-rw-r--r--man1/git-for-each-ref.146
1 files changed, 43 insertions, 3 deletions
diff --git a/man1/git-for-each-ref.1 b/man1/git-for-each-ref.1
index 58ea46979..822380e7e 100644
--- a/man1/git-for-each-ref.1
+++ b/man1/git-for-each-ref.1
@@ -2,12 +2,12 @@
.\" Title: git-for-each-ref
.\" Author: [FIXME: author] [see http://www.docbook.org/tdg5/en/html/author]
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/>
-.\" Date: 2023-07-28
+.\" Date: 2023-08-02
.\" Manual: Git Manual
-.\" Source: Git 2.41.0.478.gee48e70a82
+.\" Source: Git 2.41.0.494.g1b0a512956
.\" Language: English
.\"
-.TH "GIT\-FOR\-EACH\-REF" "1" "2023\-07\-28" "Git 2\&.41\&.0\&.478\&.gee48e7" "Git Manual"
+.TH "GIT\-FOR\-EACH\-REF" "1" "2023\-08\-02" "Git 2\&.41\&.0\&.494\&.g1b0a51" "Git Manual"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
@@ -403,6 +403,46 @@ Two integers, separated by a space, demonstrating the number of commits ahead an
\fB<committish>\fR
specified in the format\&.
.RE
+.PP
+describe[:options]
+.RS 4
+A human\-readable name, like
+\fBgit-describe\fR(1); empty string for undescribable commits\&. The
+\fBdescribe\fR
+string may be followed by a colon and one or more comma\-separated options\&.
+.PP
+tags=<bool\-value>
+.RS 4
+Instead of only considering annotated tags, consider lightweight tags as well; see the corresponding option in
+\fBgit-describe\fR(1)
+for details\&.
+.RE
+.PP
+abbrev=<number>
+.RS 4
+Use at least <number> hexadecimal digits; see the corresponding option in
+\fBgit-describe\fR(1)
+for details\&.
+.RE
+.PP
+match=<pattern>
+.RS 4
+Only consider tags matching the given
+\fBglob(7)\fR
+pattern, excluding the "refs/tags/" prefix; see the corresponding option in
+\fBgit-describe\fR(1)
+for details\&.
+.RE
+.PP
+exclude=<pattern>
+.RS 4
+Do not consider tags matching the given
+\fBglob(7)\fR
+pattern, excluding the "refs/tags/" prefix; see the corresponding option in
+\fBgit-describe\fR(1)
+for details\&.
+.RE
+.RE
.sp
In addition to the above, for commit and tag objects, the header field names (\fBtree\fR, \fBparent\fR, \fBobject\fR, \fBtype\fR, and \fBtag\fR) can be used to specify the value in the header field\&. Fields \fBtree\fR and \fBparent\fR can also be used with modifier \fB:short\fR and \fB:short=<length>\fR just like \fBobjectname\fR\&.
.sp