]>
Commit | Line | Data |
---|---|---|
bd321bcc JS |
1 | git-name-rev(1) |
2 | =============== | |
3 | ||
4 | NAME | |
5 | ---- | |
7bd7f280 | 6 | git-name-rev - Find symbolic names for given revs |
bd321bcc JS |
7 | |
8 | ||
9 | SYNOPSIS | |
10 | -------- | |
e448ff87 | 11 | [verse] |
2afc29aa JS |
12 | 'git-name-rev' [--tags] [--refs=<pattern>] |
13 | ( --all | --stdin | <committish>... ) | |
bd321bcc JS |
14 | |
15 | DESCRIPTION | |
16 | ----------- | |
17 | Finds symbolic names suitable for human digestion for revisions given in any | |
18 | format parsable by git-rev-parse. | |
19 | ||
20 | ||
21 | OPTIONS | |
22 | ------- | |
23 | ||
24 | --tags:: | |
25 | Do not use branch names, but only tags to name the commits | |
26 | ||
2afc29aa JS |
27 | --refs=<pattern>:: |
28 | Only use refs whose names match a given shell pattern. | |
29 | ||
bd321bcc JS |
30 | --all:: |
31 | List all commits reachable from all refs | |
32 | ||
33 | --stdin:: | |
82e5a82f | 34 | Read from stdin, append "(<rev_name>)" to all sha1's of nameable |
bd321bcc JS |
35 | commits, and pass to stdout |
36 | ||
23615708 SP |
37 | --name-only:: |
38 | Instead of printing both the SHA-1 and the name, print only | |
39 | the name. If given with --tags the usual tag prefix of | |
02783075 | 40 | "tags/" is also omitted from the name, matching the output |
5f8bee58 | 41 | of gitlink:git-describe[1] more closely. This option |
23615708 SP |
42 | cannot be combined with --stdin. |
43 | ||
bd321bcc JS |
44 | EXAMPLE |
45 | ------- | |
46 | ||
47 | Given a commit, find out where it is relative to the local refs. Say somebody | |
2a75848e | 48 | wrote you about that fantastic commit 33db5f4d9027a10e477ccf054b2c1ab94f74c85a. |
bd321bcc JS |
49 | Of course, you look into the commit, but that only tells you what happened, but |
50 | not the context. | |
51 | ||
52 | Enter git-name-rev: | |
53 | ||
54 | ------------ | |
55 | % git name-rev 33db5f4d9027a10e477ccf054b2c1ab94f74c85a | |
2b5f3ed3 | 56 | 33db5f4d9027a10e477ccf054b2c1ab94f74c85a tags/v0.99^0~940 |
bd321bcc JS |
57 | ------------ |
58 | ||
59 | Now you are wiser, because you know that it happened 940 revisions before v0.99. | |
60 | ||
61 | Another nice thing you can do is: | |
62 | ||
63 | ------------ | |
64 | % git log | git name-rev --stdin | |
65 | ------------ | |
66 | ||
67 | ||
68 | Author | |
69 | ------ | |
70 | Written by Johannes Schindelin <Johannes.Schindelin@gmx.de> | |
71 | ||
72 | Documentation | |
73 | -------------- | |
74 | Documentation by Johannes Schindelin. | |
75 | ||
76 | GIT | |
77 | --- | |
78 | Part of the gitlink:git[7] suite |