X-Git-Url: https://git.tokkee.org/?a=blobdiff_plain;f=Documentation%2Fgit-name-rev.txt;h=5b5c4c865f49d1da36fa1fbbcae96a33fd8da9a4;hb=0e070f997b529e81f7daff79fea1b61bc9166f6b;hp=ffaa00468f0c16f19ab632aac20aaa74db52b325;hpb=0e84fb06a1022f99c96cfcd728e7bf029ef0b5e3;p=git.git diff --git a/Documentation/git-name-rev.txt b/Documentation/git-name-rev.txt index ffaa00468..5b5c4c865 100644 --- a/Documentation/git-name-rev.txt +++ b/Documentation/git-name-rev.txt @@ -8,7 +8,8 @@ git-name-rev - Find symbolic names for given revs SYNOPSIS -------- -'git-name-rev' [--tags] ( --all | --stdin | ... ) +'git-name-rev' [--tags] [--refs=] + ( --all | --stdin | ... ) DESCRIPTION ----------- @@ -22,18 +23,21 @@ 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 --stdin:: - Read from stdin, append "()" to all sha1's of name'able + Read from stdin, append "()" to all sha1's of nameable commits, and pass to stdout 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.