X-Git-Url: https://git.tokkee.org/?a=blobdiff_plain;f=Documentation%2Fgit-name-rev.txt;h=7ca8a7b48cea191b58db93581f02fa4ff265acdc;hb=104d3794481c83f8db00ccf85134fc55c76852f9;hp=efcabdc27267a80827d9cc22649e6855e3ce3ae9;hpb=887ad79865d862a0a3aef4b59957d7dd95d0507d;p=git.git diff --git a/Documentation/git-name-rev.txt b/Documentation/git-name-rev.txt index efcabdc27..7ca8a7b48 100644 --- a/Documentation/git-name-rev.txt +++ b/Documentation/git-name-rev.txt @@ -9,13 +9,13 @@ git-name-rev - Find symbolic names for given revs SYNOPSIS -------- [verse] -'git-name-rev' [--tags] [--refs=] +'git name-rev' [--tags] [--refs=] ( --all | --stdin | ... ) DESCRIPTION ----------- Finds symbolic names suitable for human digestion for revisions given in any -format parsable by git-rev-parse. +format parsable by 'git-rev-parse'. OPTIONS @@ -38,8 +38,14 @@ OPTIONS 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 linkgit:git-describe[1] more closely. This option - cannot be combined with --stdin. + of `git-describe` more closely. + +--no-undefined:: + Die with error code != 0 when a reference is undefined, + instead of printing `undefined`. + +--always:: + Show uniquely abbreviated commit object as fallback. EXAMPLE ------- @@ -49,11 +55,11 @@ 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. -Enter git-name-rev: +Enter 'git-name-rev': ------------ % git name-rev 33db5f4d9027a10e477ccf054b2c1ab94f74c85a -33db5f4d9027a10e477ccf054b2c1ab94f74c85a tags/v0.99^0~940 +33db5f4d9027a10e477ccf054b2c1ab94f74c85a tags/v0.99~940 ------------ Now you are wiser, because you know that it happened 940 revisions before v0.99. @@ -75,4 +81,4 @@ Documentation by Johannes Schindelin. GIT --- -Part of the linkgit:git[7] suite +Part of the linkgit:git[1] suite