]>
Commit | Line | Data |
---|---|---|
4e783b41 PB |
1 | git-show(1) |
2 | =========== | |
3 | ||
4 | NAME | |
5 | ---- | |
5d7eeee2 | 6 | git-show - Show various types of objects |
4e783b41 PB |
7 | |
8 | ||
9 | SYNOPSIS | |
10 | -------- | |
b1889c36 | 11 | 'git show' [options] <object>... |
4e783b41 PB |
12 | |
13 | DESCRIPTION | |
14 | ----------- | |
5d7eeee2 JS |
15 | Shows one or more objects (blobs, trees, tags and commits). |
16 | ||
17 | For commits it shows the log message and textual diff. It also | |
18 | presents the merge commit in a special format as produced by | |
0b444cdb | 19 | 'git diff-tree --cc'. |
5d7eeee2 JS |
20 | |
21 | For tags, it shows the tag message and the referenced objects. | |
22 | ||
0b444cdb | 23 | For trees, it shows the names (equivalent to 'git ls-tree' |
5d7eeee2 JS |
24 | with \--name-only). |
25 | ||
26 | For plain blobs, it shows the plain contents. | |
4e783b41 | 27 | |
0b444cdb | 28 | The command takes options applicable to the 'git diff-tree' command to |
66e788bc MT |
29 | control how the changes the commit introduces are shown. |
30 | ||
4e783b41 PB |
31 | This manual page describes only the most frequently used options. |
32 | ||
33 | ||
34 | OPTIONS | |
35 | ------- | |
f448e24e AMS |
36 | <object>...:: |
37 | The names of objects to show. | |
41a5564e | 38 | For a more complete list of ways to spell object names, see |
5162e697 | 39 | "SPECIFYING REVISIONS" section in linkgit:git-rev-parse[1]. |
4e783b41 | 40 | |
331b51d2 JN |
41 | include::pretty-options.txt[] |
42 | ||
43 | ||
5d1faf87 | 44 | include::pretty-formats.txt[] |
4e783b41 | 45 | |
5d7eeee2 JS |
46 | |
47 | EXAMPLES | |
48 | -------- | |
49 | ||
50 | git show v1.0.0:: | |
99e09cce JH |
51 | Shows the tag `v1.0.0`, along with the object the tags |
52 | points at. | |
5d7eeee2 | 53 | |
7ee70a71 | 54 | git show v1.0.0^\{tree\}:: |
5d7eeee2 JS |
55 | Shows the tree pointed to by the tag `v1.0.0`. |
56 | ||
7ee70a71 | 57 | git show next~10:Documentation/README:: |
5d7eeee2 JS |
58 | Shows the contents of the file `Documentation/README` as |
59 | they were current in the 10th last commit of the branch | |
60 | `next`. | |
61 | ||
7ee70a71 | 62 | git show master:Makefile master:t/Makefile:: |
5d7eeee2 JS |
63 | Concatenates the contents of said Makefiles in the head |
64 | of the branch `master`. | |
65 | ||
5dc7bcc2 JH |
66 | Discussion |
67 | ---------- | |
68 | ||
69 | include::i18n.txt[] | |
70 | ||
4e783b41 PB |
71 | Author |
72 | ------ | |
73 | Written by Linus Torvalds <torvalds@osdl.org> and | |
59eb68aa | 74 | Junio C Hamano <gitster@pobox.com>. Significantly enhanced by |
99e09cce | 75 | Johannes Schindelin <Johannes.Schindelin@gmx.de>. |
4e783b41 PB |
76 | |
77 | ||
78 | Documentation | |
79 | ------------- | |
80 | Documentation by David Greaves, Petr Baudis and the git-list <git@vger.kernel.org>. | |
81 | ||
4e783b41 PB |
82 | GIT |
83 | --- | |
9e1f0a85 | 84 | Part of the linkgit:git[1] suite |