doc: mention 'git show' defaults to HEAD
[git/git.git] / Documentation / git-show.txt
CommitLineData
4e783b41
PB
1git-show(1)
2===========
3
4NAME
5----
5d7eeee2 6git-show - Show various types of objects
4e783b41
PB
7
8
9SYNOPSIS
10--------
7791a1d9 11[verse]
9f5258cb 12'git show' [options] [<object>...]
4e783b41
PB
13
14DESCRIPTION
15-----------
5d7eeee2
JS
16Shows one or more objects (blobs, trees, tags and commits).
17
18For commits it shows the log message and textual diff. It also
19presents the merge commit in a special format as produced by
0b444cdb 20'git diff-tree --cc'.
5d7eeee2
JS
21
22For tags, it shows the tag message and the referenced objects.
23
0b444cdb 24For trees, it shows the names (equivalent to 'git ls-tree'
1c262bb7 25with --name-only).
5d7eeee2
JS
26
27For plain blobs, it shows the plain contents.
4e783b41 28
0b444cdb 29The command takes options applicable to the 'git diff-tree' command to
66e788bc
MT
30control how the changes the commit introduces are shown.
31
4e783b41
PB
32This manual page describes only the most frequently used options.
33
34
35OPTIONS
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
42include::pretty-options.txt[]
43
44
5d1faf87 45include::pretty-formats.txt[]
4e783b41 46
5d7eeee2 47
0791ab02
MM
48COMMON DIFF OPTIONS
49-------------------
50
51:git-log: 1
52include::diff-options.txt[]
53
54include::diff-generate-patch.txt[]
55
56
5d7eeee2
JS
57EXAMPLES
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
5dc7bcc2
JH
80Discussion
81----------
82
83include::i18n.txt[]
84
4e783b41
PB
85GIT
86---
9e1f0a85 87Part of the linkgit:git[1] suite