]>
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 | -------- | |
7791a1d9 | 11 | [verse] |
de613050 | 12 | 'git show' [<options>] [<object>...] |
4e783b41 PB |
13 | |
14 | DESCRIPTION | |
15 | ----------- | |
5d7eeee2 JS |
16 | Shows one or more objects (blobs, trees, tags and commits). |
17 | ||
18 | For commits it shows the log message and textual diff. It also | |
19 | presents the merge commit in a special format as produced by | |
0b444cdb | 20 | 'git diff-tree --cc'. |
5d7eeee2 JS |
21 | |
22 | For tags, it shows the tag message and the referenced objects. | |
23 | ||
0b444cdb | 24 | For trees, it shows the names (equivalent to 'git ls-tree' |
1c262bb7 | 25 | with --name-only). |
5d7eeee2 JS |
26 | |
27 | For plain blobs, it shows the plain contents. | |
4e783b41 | 28 | |
0b444cdb | 29 | The command takes options applicable to the 'git diff-tree' command to |
66e788bc MT |
30 | control how the changes the commit introduces are shown. |
31 | ||
4e783b41 PB |
32 | This manual page describes only the most frequently used options. |
33 | ||
34 | ||
35 | OPTIONS | |
36 | ------- | |
f448e24e | 37 | <object>...:: |
9f5258cb | 38 | The names of objects to show (defaults to 'HEAD'). |
41a5564e | 39 | For a more complete list of ways to spell object names, see |
9d83e382 | 40 | "SPECIFYING REVISIONS" section in linkgit:gitrevisions[7]. |
4e783b41 | 41 | |
331b51d2 JN |
42 | include::pretty-options.txt[] |
43 | ||
44 | ||
5d1faf87 | 45 | include::pretty-formats.txt[] |
4e783b41 | 46 | |
5d7eeee2 | 47 | |
0791ab02 MM |
48 | COMMON DIFF OPTIONS |
49 | ------------------- | |
50 | ||
51 | :git-log: 1 | |
52 | include::diff-options.txt[] | |
53 | ||
54 | include::diff-generate-patch.txt[] | |
55 | ||
56 | ||
5d7eeee2 JS |
57 | EXAMPLES |
58 | -------- | |
59 | ||
5d2fc913 | 60 | `git show v1.0.0`:: |
99e09cce JH |
61 | Shows the tag `v1.0.0`, along with the object the tags |
62 | points at. | |
5d7eeee2 | 63 | |
6cf378f0 | 64 | `git show v1.0.0^{tree}`:: |
5d7eeee2 JS |
65 | Shows the tree pointed to by the tag `v1.0.0`. |
66 | ||
6cf378f0 | 67 | `git show -s --format=%s v1.0.0^{commit}`:: |
60aa9cf8 JN |
68 | Shows the subject of the commit pointed to by the |
69 | tag `v1.0.0`. | |
70 | ||
5d2fc913 | 71 | `git show next~10:Documentation/README`:: |
5d7eeee2 JS |
72 | Shows the contents of the file `Documentation/README` as |
73 | they were current in the 10th last commit of the branch | |
74 | `next`. | |
75 | ||
5d2fc913 | 76 | `git show master:Makefile master:t/Makefile`:: |
5d7eeee2 JS |
77 | Concatenates the contents of said Makefiles in the head |
78 | of the branch `master`. | |
79 | ||
76a8788c | 80 | DISCUSSION |
5dc7bcc2 JH |
81 | ---------- |
82 | ||
83 | include::i18n.txt[] | |
84 | ||
4e783b41 PB |
85 | GIT |
86 | --- | |
9e1f0a85 | 87 | Part of the linkgit:git[1] suite |