summaryrefslogtreecommitdiff
path: root/Documentation/git-for-each-ref.txt
diff options
context:
space:
mode:
authorJeff King <peff@peff.net>2015-05-21 00:45:55 -0400
committerJunio C Hamano <gitster@pobox.com>2015-05-22 09:33:09 -0700
commit29bc88505f22068d7ee6694240e6b13fddb5d059 (patch)
treea55a77a4756632a07aa634bc1c1ce7a8f79fb256 /Documentation/git-for-each-ref.txt
parent3dbe9db01bd9c0b0701f72a631ac15b1791f6642 (diff)
downloadgit-29bc88505f22068d7ee6694240e6b13fddb5d059.tar.gz
for-each-ref: accept "%(push)" formatjk/at-push-sha1
Just as we have "%(upstream)" to report the "@{upstream}" for each ref, this patch adds "%(push)" to match "@{push}". It supports the same tracking format modifiers as upstream (because you may want to know, for example, which branches have commits to push). Signed-off-by: Jeff King <peff@peff.net> Signed-off-by: Junio C Hamano <gitster@pobox.com>
Diffstat (limited to 'Documentation/git-for-each-ref.txt')
-rw-r--r--Documentation/git-for-each-ref.txt6
1 files changed, 6 insertions, 0 deletions
diff --git a/Documentation/git-for-each-ref.txt b/Documentation/git-for-each-ref.txt
index 42408752d0..7f8d9a5b5f 100644
--- a/Documentation/git-for-each-ref.txt
+++ b/Documentation/git-for-each-ref.txt
@@ -97,6 +97,12 @@ upstream::
or "=" (in sync). Has no effect if the ref does not have
tracking information associated with it.
+push::
+ The name of a local ref which represents the `@{push}` location
+ for the displayed ref. Respects `:short`, `:track`, and
+ `:trackshort` options as `upstream` does. Produces an empty
+ string if no `@{push}` ref is configured.
+
HEAD::
'*' if HEAD matches current ref (the checked out branch), ' '
otherwise.