]>
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 |
9d83e382 | 39 | "SPECIFYING REVISIONS" section in linkgit:gitrevisions[7]. |
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 | ||
60aa9cf8 JN |
57 | git show -s --format=%s v1.0.0^\{commit\}:: |
58 | Shows the subject of the commit pointed to by the | |
59 | tag `v1.0.0`. | |
60 | ||
7ee70a71 | 61 | git show next~10:Documentation/README:: |
5d7eeee2 JS |
62 | Shows the contents of the file `Documentation/README` as |
63 | they were current in the 10th last commit of the branch | |
64 | `next`. | |
65 | ||
7ee70a71 | 66 | git show master:Makefile master:t/Makefile:: |
5d7eeee2 JS |
67 | Concatenates the contents of said Makefiles in the head |
68 | of the branch `master`. | |
69 | ||
5dc7bcc2 JH |
70 | Discussion |
71 | ---------- | |
72 | ||
73 | include::i18n.txt[] | |
74 | ||
4e783b41 PB |
75 | Author |
76 | ------ | |
77 | Written by Linus Torvalds <torvalds@osdl.org> and | |
59eb68aa | 78 | Junio C Hamano <gitster@pobox.com>. Significantly enhanced by |
99e09cce | 79 | Johannes Schindelin <Johannes.Schindelin@gmx.de>. |
4e783b41 PB |
80 | |
81 | ||
82 | Documentation | |
83 | ------------- | |
84 | Documentation by David Greaves, Petr Baudis and the git-list <git@vger.kernel.org>. | |
85 | ||
4e783b41 PB |
86 | GIT |
87 | --- | |
9e1f0a85 | 88 | Part of the linkgit:git[1] suite |