X-Git-Url: https://git.tokkee.org/?a=blobdiff_plain;f=Documentation%2Fgit-name-rev.txt;h=306e1a4956eb72892729a3283c29ee6355da2c22;hb=08e1812db1585c450bfe7f41e7106222346c88da;hp=43f8c2593dcc010b97b24cc8f5ca1caada7bef3b;hpb=82e5a82fd73edb80a841f5fab1660e14b9b8f3ad;p=git.git diff --git a/Documentation/git-name-rev.txt b/Documentation/git-name-rev.txt index 43f8c2593..306e1a495 100644 --- a/Documentation/git-name-rev.txt +++ b/Documentation/git-name-rev.txt @@ -8,7 +8,9 @@ git-name-rev - Find symbolic names for given revs SYNOPSIS -------- -'git-name-rev' [--tags] ( --all | --stdin | ... ) +[verse] +'git-name-rev' [--tags] [--refs=] + ( --all | --stdin | ... ) DESCRIPTION ----------- @@ -22,6 +24,9 @@ OPTIONS --tags:: Do not use branch names, but only tags to name the commits +--refs=:: + Only use refs whose names match a given shell pattern. + --all:: List all commits reachable from all refs @@ -29,11 +34,18 @@ OPTIONS Read from stdin, append "()" to all sha1's of nameable commits, and pass to stdout +--name-only:: + Instead of printing both the SHA-1 and the name, print only + the name. If given with --tags the usual tag prefix of + "tags/" is also omitted from the name, matching the output + of gitlink::git-describe[1] more closely. This option + cannot be combined with --stdin. + EXAMPLE ------- Given a commit, find out where it is relative to the local refs. Say somebody -wrote you about that phantastic commit 33db5f4d9027a10e477ccf054b2c1ab94f74c85a. +wrote you about that fantastic commit 33db5f4d9027a10e477ccf054b2c1ab94f74c85a. Of course, you look into the commit, but that only tells you what happened, but not the context. @@ -64,4 +76,3 @@ Documentation by Johannes Schindelin. GIT --- Part of the gitlink:git[7] suite -