git-sh-setup.sh: add variable to use the stuck-long mode
[gitweb.git] / Documentation / git-for-each-ref.txt
index 8f87c9a1ef733b98987fad377850fbcf2272ae95..42408752d0848f0854308407ff7606b40f1e6eed 100644 (file)
@@ -91,12 +91,20 @@ objectname::
 upstream::
        The name of a local ref which can be considered ``upstream''
        from the displayed ref. Respects `:short` in the same way as
-       `refname` above.
+       `refname` above.  Additionally respects `:track` to show
+       "[ahead N, behind M]" and `:trackshort` to show the terse
+       version: ">" (ahead), "<" (behind), "<>" (ahead and behind),
+       or "=" (in sync).  Has no effect if the ref does not have
+       tracking information associated with it.
 
 HEAD::
        '*' if HEAD matches current ref (the checked out branch), ' '
        otherwise.
 
+color::
+       Change output color.  Followed by `:<colorname>`, where names
+       are described in `color.branch.*`.
+
 In addition to the above, for commit and tag objects, the header
 field names (`tree`, `parent`, `object`, `type`, and `tag`) can
 be used to specify the value in the header field.
@@ -211,13 +219,9 @@ eval=`git for-each-ref --shell --format="$fmt" \
 eval "$eval"
 ------------
 
-Author
-------
-Written by Junio C Hamano <gitster@pobox.com>.
-
-Documentation
--------------
-Documentation by Junio C Hamano and the git-list <git@vger.kernel.org>.
+SEE ALSO
+--------
+linkgit:git-show-ref[1]
 
 GIT
 ---