kernel
/
git
mirror of https://git.kernel.org/pub/scm/git/git.git
1
0
Fork 0
Code Releases Activity

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>
maint
Michael J Gruber 2017-08-18 16:51:22 +02:00 committed by Junio C Hamano
parent 4d7268b888
commit e4933cee53
3 changed files with 6 additions and 6 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

4
Documentation/git-branch.txt
View File

@ -267,8 +267,8 @@ start-point is either a local or remote-tracking branch.
Only list branches of the given object. Only list branches of the given object.


--format <format>:: --format <format>::
A string that interpolates `%(fieldname)` from the object A string that interpolates `%(fieldname)` from a branch ref being shown
pointed at by a ref being shown. The format is the same as and the object it points at. The format is the same as
that of linkgit:git-for-each-ref[1]. that of linkgit:git-for-each-ref[1].


Examples Examples

4
Documentation/git-for-each-ref.txt
View File

@ -38,8 +38,8 @@ OPTIONS
key. key.


<format>:: <format>::
A string that interpolates `%(fieldname)` from the A string that interpolates `%(fieldname)` from a ref being shown
object pointed at by a ref being shown. If `fieldname` and the object it points at. If `fieldname`
is prefixed with an asterisk (`*`) and the ref points is prefixed with an asterisk (`*`) and the ref points
at a tag object, the value for the field in the object at a tag object, the value for the field in the object
tag refers is used. When unspecified, defaults to tag refers is used. When unspecified, defaults to

4
Documentation/git-tag.txt
View File

@ -188,8 +188,8 @@ This option is only applicable when listing tags without annotation lines.
Defaults to HEAD. Defaults to HEAD.


<format>:: <format>::
A string that interpolates `%(fieldname)` from the object A string that interpolates `%(fieldname)` from a tag ref being shown
pointed at by a ref being shown. The format is the same as and the object it points at. The format is the same as
that of linkgit:git-for-each-ref[1]. When unspecified, that of linkgit:git-for-each-ref[1]. When unspecified,
defaults to `%(refname:strip=2)`. defaults to `%(refname:strip=2)`.