Documentation: use proper wording for ref format strings
authorMichael J Gruber <git@grubix.eu>
Fri, 18 Aug 2017 14:51:22 +0000 (16:51 +0200)
committerJunio C Hamano <gitster@pobox.com>
Fri, 18 Aug 2017 16:54:09 +0000 (09:54 -0700)
commite4933cee53bce14ae040d02d0febd678c5686dde
treecdb74d59fc1ebe5ac13037da5607b05157f57070
parent4d7268b888d7bb6d675340ec676e4239739d0f6d
Documentation: use proper wording for ref format strings

Various commands list refs and allow to use a format string for the
output that interpolates from the ref as well as the object it points
at (for-each-ref; branch and tag in list mode).

Currently, the documentation talks about interpolating from the object.
This is confusing because a ref points to an object but not vice versa,
so the object cannot possible know %(refname), for example. Thus, this is
wrong independent of refs being objects (one day, maybe) or not.

Change the wording to make this clearer (and distinguish it from formats
for the log family).

Signed-off-by: Michael J Gruber <git@grubix.eu>
Signed-off-by: Junio C Hamano <gitster@pobox.com>
Documentation/git-branch.txt
Documentation/git-for-each-ref.txt
Documentation/git-tag.txt