blob: baaf2bc8feefe4fb88a1ec43d2f70bbfdfe6fbf6 [file] [log] [blame]
Petr Baudis4e783b42006-02-07 12:47:47 +01001git-show(1)
2===========
3
4NAME
5----
Johannes Schindelin5d7eeee2006-12-14 11:31:05 +01006git-show - Show various types of objects
Petr Baudis4e783b42006-02-07 12:47:47 +01007
8
9SYNOPSIS
10--------
Johannes Schindelin5d7eeee2006-12-14 11:31:05 +010011'git-show' [options] <object>...
Petr Baudis4e783b42006-02-07 12:47:47 +010012
13DESCRIPTION
14-----------
Johannes Schindelin5d7eeee2006-12-14 11:31:05 +010015Shows one or more objects (blobs, trees, tags and commits).
16
17For commits it shows the log message and textual diff. It also
18presents the merge commit in a special format as produced by
19'git-diff-tree --cc'.
20
21For tags, it shows the tag message and the referenced objects.
22
Dan McGee5162e692007-12-29 00:20:38 -060023For trees, it shows the names (equivalent to linkgit:git-ls-tree[1]
Johannes Schindelin5d7eeee2006-12-14 11:31:05 +010024with \--name-only).
25
26For plain blobs, it shows the plain contents.
Petr Baudis4e783b42006-02-07 12:47:47 +010027
Dan McGee5162e692007-12-29 00:20:38 -060028The command takes options applicable to the linkgit:git-diff-tree[1] command to
Michael S. Tsirkin66e788b2007-02-08 15:22:21 -080029control how the changes the commit introduces are shown.
30
Petr Baudis4e783b42006-02-07 12:47:47 +010031This manual page describes only the most frequently used options.
32
33
34OPTIONS
35-------
Junio C Hamano99e09cc2006-12-30 02:21:48 -080036<object>::
37 The name of the object to show.
Shawn O. Pearce41a55642007-01-17 21:08:09 -050038 For a more complete list of ways to spell object names, see
Dan McGee5162e692007-12-29 00:20:38 -060039 "SPECIFYING REVISIONS" section in linkgit:git-rev-parse[1].
Petr Baudis4e783b42006-02-07 12:47:47 +010040
Jakub Narebski331b51d2007-05-14 01:25:45 +020041include::pretty-options.txt[]
42
43
Chris Riddoch5d1faf82006-11-21 16:49:15 -070044include::pretty-formats.txt[]
Petr Baudis4e783b42006-02-07 12:47:47 +010045
Johannes Schindelin5d7eeee2006-12-14 11:31:05 +010046
47EXAMPLES
48--------
49
50git show v1.0.0::
Junio C Hamano99e09cc2006-12-30 02:21:48 -080051 Shows the tag `v1.0.0`, along with the object the tags
52 points at.
Johannes Schindelin5d7eeee2006-12-14 11:31:05 +010053
Theodore Tso7ee70a72007-02-27 10:43:28 -050054git show v1.0.0^\{tree\}::
Johannes Schindelin5d7eeee2006-12-14 11:31:05 +010055 Shows the tree pointed to by the tag `v1.0.0`.
56
Theodore Tso7ee70a72007-02-27 10:43:28 -050057git show next~10:Documentation/README::
Johannes Schindelin5d7eeee2006-12-14 11:31:05 +010058 Shows the contents of the file `Documentation/README` as
59 they were current in the 10th last commit of the branch
60 `next`.
61
Theodore Tso7ee70a72007-02-27 10:43:28 -050062git show master:Makefile master:t/Makefile::
Johannes Schindelin5d7eeee2006-12-14 11:31:05 +010063 Concatenates the contents of said Makefiles in the head
64 of the branch `master`.
65
Junio C Hamano5dc7bcc2006-12-30 02:22:38 -080066Discussion
67----------
68
69include::i18n.txt[]
70
Petr Baudis4e783b42006-02-07 12:47:47 +010071Author
72------
73Written by Linus Torvalds <torvalds@osdl.org> and
Junio C Hamano99e09cc2006-12-30 02:21:48 -080074Junio C Hamano <junkio@cox.net>. Significantly enhanced by
75Johannes Schindelin <Johannes.Schindelin@gmx.de>.
Petr Baudis4e783b42006-02-07 12:47:47 +010076
77
78Documentation
79-------------
80Documentation by David Greaves, Petr Baudis and the git-list <git@vger.kernel.org>.
81
Petr Baudis4e783b42006-02-07 12:47:47 +010082GIT
83---
Christian Couder9e1f0a82008-06-06 09:07:32 +020084Part of the linkgit:git[1] suite