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.123
1 files changed, 19 insertions, 4 deletions
diff --git a/man1/git-for-each-ref.1 b/man1/git-for-each-ref.1
index e8c738489..fdfa83a19 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: 04/04/2023
+.\" Date: 04/06/2023
.\" Manual: Git Manual
-.\" Source: Git 2.40.0.214.gae73b2c8f1
+.\" Source: Git 2.40.0.315.g0607f793cb
.\" Language: English
.\"
-.TH "GIT\-FOR\-EACH\-REF" "1" "04/04/2023" "Git 2\&.40\&.0\&.214\&.gae73b2" "Git Manual"
+.TH "GIT\-FOR\-EACH\-REF" "1" "04/06/2023" "Git 2\&.40\&.0\&.315\&.g0607f7" "Git Manual"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
@@ -33,7 +33,8 @@ git-for-each-ref \- Output information on each ref
.sp
.nf
\fIgit for\-each\-ref\fR [\-\-count=<count>] [\-\-shell|\-\-perl|\-\-python|\-\-tcl]
- [(\-\-sort=<key>)\&...] [\-\-format=<format>] [<pattern>\&...]
+ [(\-\-sort=<key>)\&...] [\-\-format=<format>]
+ [ \-\-stdin | <pattern>\&... ]
[\-\-points\-at=<object>]
[\-\-merged[=<object>]] [\-\-no\-merged[=<object>]]
[\-\-contains[=<object>]] [\-\-no\-contains[=<object>]]
@@ -49,6 +50,13 @@ Iterate over all refs that match \fB<pattern>\fR and show them according to the
If one or more patterns are given, only refs are shown that match against at least one pattern, either using fnmatch(3) or literally, in the latter case matching completely or from the beginning up to a slash\&.
.RE
.PP
+\-\-stdin
+.RS 4
+If
+\fB\-\-stdin\fR
+is supplied, then the list of patterns is read from standard input instead of from the argument list\&.
+.RE
+.PP
\-\-count=<count>
.RS 4
By default the command shows all refs that match
@@ -334,6 +342,13 @@ worktreepath
.RS 4
The absolute path to the worktree in which the ref is checked out, if it is checked out in any linked worktree\&. Empty string otherwise\&.
.RE
+.PP
+ahead\-behind:<committish>
+.RS 4
+Two integers, separated by a space, demonstrating the number of commits ahead and behind, respectively, when comparing the output ref to the
+\fB<committish>\fR
+specified in the format\&.
+.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