Johannes Schindelin | bd321bc | 2005-10-26 15:10:20 +0200 | [diff] [blame] | 1 | git-name-rev(1) |
| 2 | =============== |
| 3 | |
| 4 | NAME |
| 5 | ---- |
Fredrik Kuivinen | 7bd7f28 | 2006-03-09 17:24:50 +0100 | [diff] [blame] | 6 | git-name-rev - Find symbolic names for given revs |
Johannes Schindelin | bd321bc | 2005-10-26 15:10:20 +0200 | [diff] [blame] | 7 | |
| 8 | |
| 9 | SYNOPSIS |
| 10 | -------- |
Matthias Kestenholz | e448ff8 | 2007-05-18 15:39:33 +0200 | [diff] [blame] | 11 | [verse] |
Jonathan Nieder | b1889c3 | 2008-06-30 01:09:04 -0500 | [diff] [blame] | 12 | 'git name-rev' [--tags] [--refs=<pattern>] |
Richard Hansen | a8a5406 | 2013-09-04 15:04:31 -0400 | [diff] [blame] | 13 | ( --all | --stdin | <commit-ish>... ) |
Johannes Schindelin | bd321bc | 2005-10-26 15:10:20 +0200 | [diff] [blame] | 14 | |
| 15 | DESCRIPTION |
| 16 | ----------- |
| 17 | Finds symbolic names suitable for human digestion for revisions given in any |
Thomas Rast | 0b444cd | 2010-01-10 00:33:00 +0100 | [diff] [blame] | 18 | format parsable by 'git rev-parse'. |
Johannes Schindelin | bd321bc | 2005-10-26 15:10:20 +0200 | [diff] [blame] | 19 | |
| 20 | |
| 21 | OPTIONS |
| 22 | ------- |
| 23 | |
| 24 | --tags:: |
| 25 | Do not use branch names, but only tags to name the commits |
| 26 | |
Johannes Schindelin | 2afc29a | 2007-02-17 19:22:35 +0100 | [diff] [blame] | 27 | --refs=<pattern>:: |
Namhyung Kim | 98c5c4a | 2013-06-18 21:35:31 +0900 | [diff] [blame] | 28 | Only use refs whose names match a given shell pattern. The pattern |
| 29 | can be one of branch name, tag name or fully qualified ref name. |
Johannes Schindelin | 2afc29a | 2007-02-17 19:22:35 +0100 | [diff] [blame] | 30 | |
Johannes Schindelin | bd321bc | 2005-10-26 15:10:20 +0200 | [diff] [blame] | 31 | --all:: |
| 32 | List all commits reachable from all refs |
| 33 | |
| 34 | --stdin:: |
Ramkumar Ramachandra | 3087b61 | 2013-07-07 18:13:16 +0530 | [diff] [blame] | 35 | Transform stdin by substituting all the 40-character SHA-1 |
| 36 | hexes (say $hex) with "$hex ($rev_name)". When used with |
| 37 | --name-only, substitute with "$rev_name", omitting $hex |
| 38 | altogether. Intended for the scripter's use. |
Johannes Schindelin | bd321bc | 2005-10-26 15:10:20 +0200 | [diff] [blame] | 39 | |
Shawn O. Pearce | 2361570 | 2007-05-21 03:20:25 -0400 | [diff] [blame] | 40 | --name-only:: |
| 41 | Instead of printing both the SHA-1 and the name, print only |
| 42 | the name. If given with --tags the usual tag prefix of |
Brian Hetro | 0278307 | 2007-08-23 20:44:13 -0400 | [diff] [blame] | 43 | "tags/" is also omitted from the name, matching the output |
Junio C Hamano | 372c767 | 2008-08-02 11:58:34 -0700 | [diff] [blame] | 44 | of `git-describe` more closely. |
Shawn O. Pearce | 2361570 | 2007-05-21 03:20:25 -0400 | [diff] [blame] | 45 | |
Stephan Beyer | eba1351 | 2008-06-08 03:36:12 +0200 | [diff] [blame] | 46 | --no-undefined:: |
| 47 | Die with error code != 0 when a reference is undefined, |
| 48 | instead of printing `undefined`. |
| 49 | |
| 50 | --always:: |
| 51 | Show uniquely abbreviated commit object as fallback. |
| 52 | |
Johannes Schindelin | bd321bc | 2005-10-26 15:10:20 +0200 | [diff] [blame] | 53 | EXAMPLE |
| 54 | ------- |
| 55 | |
| 56 | Given a commit, find out where it is relative to the local refs. Say somebody |
Alp Toker | 2a75848 | 2006-07-11 11:19:33 +0100 | [diff] [blame] | 57 | wrote you about that fantastic commit 33db5f4d9027a10e477ccf054b2c1ab94f74c85a. |
Johannes Schindelin | bd321bc | 2005-10-26 15:10:20 +0200 | [diff] [blame] | 58 | Of course, you look into the commit, but that only tells you what happened, but |
| 59 | not the context. |
| 60 | |
Thomas Rast | 0b444cd | 2010-01-10 00:33:00 +0100 | [diff] [blame] | 61 | Enter 'git name-rev': |
Johannes Schindelin | bd321bc | 2005-10-26 15:10:20 +0200 | [diff] [blame] | 62 | |
| 63 | ------------ |
| 64 | % git name-rev 33db5f4d9027a10e477ccf054b2c1ab94f74c85a |
Junio C Hamano | ee83724 | 2008-08-30 13:08:50 -0700 | [diff] [blame] | 65 | 33db5f4d9027a10e477ccf054b2c1ab94f74c85a tags/v0.99~940 |
Johannes Schindelin | bd321bc | 2005-10-26 15:10:20 +0200 | [diff] [blame] | 66 | ------------ |
| 67 | |
| 68 | Now you are wiser, because you know that it happened 940 revisions before v0.99. |
| 69 | |
| 70 | Another nice thing you can do is: |
| 71 | |
| 72 | ------------ |
| 73 | % git log | git name-rev --stdin |
| 74 | ------------ |
| 75 | |
Johannes Schindelin | bd321bc | 2005-10-26 15:10:20 +0200 | [diff] [blame] | 76 | GIT |
| 77 | --- |
Christian Couder | 9e1f0a8 | 2008-06-06 09:07:32 +0200 | [diff] [blame] | 78 | Part of the linkgit:git[1] suite |