~ubuntu-branches/ubuntu/intrepid/git-core/intrepid-updates

« back to all changes in this revision

Viewing changes to Documentation/git-show.txt

  • Committer: Package Import Robot
  • Author(s): Gerrit Pape
  • Date: 2007-04-22 13:31:05 UTC
  • mto: This revision was merged to the branch mainline in revision 20.
  • Revision ID: package-import@ubuntu.com-20070422133105-xg8fnm18r2cxcbg1
Tags: upstream-1.5.1.2
ImportĀ upstreamĀ versionĀ 1.5.1.2

Show diffs side-by-side

added added

removed removed

Lines of Context:
3
3
 
4
4
NAME
5
5
----
6
 
git-show - Show one commit with difference it introduces
 
6
git-show - Show various types of objects
7
7
 
8
8
 
9
9
SYNOPSIS
10
10
--------
11
 
'git-show' <option>...
 
11
'git-show' [options] <object>...
12
12
 
13
13
DESCRIPTION
14
14
-----------
15
 
Shows commit log and textual diff for a single commit.  The
16
 
command internally invokes 'git-rev-list' piped to
17
 
'git-diff-tree', and takes command line options for both of
18
 
these commands. It also presents the merge commit in a special
19
 
format as produced by 'git-diff-tree --cc'.
 
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
 
19
'git-diff-tree --cc'.
 
20
 
 
21
For tags, it shows the tag message and the referenced objects.
 
22
 
 
23
For trees, it shows the names (equivalent to gitlink:git-ls-tree[1]
 
24
with \--name-only).
 
25
 
 
26
For plain blobs, it shows the plain contents.
 
27
 
 
28
The command takes options applicable to the gitlink:git-diff-tree[1] command to
 
29
control how the changes the commit introduces are shown.
20
30
 
21
31
This manual page describes only the most frequently used options.
22
32
 
23
33
 
24
34
OPTIONS
25
35
-------
26
 
<commitid>::
27
 
        ID of the commit to show.
 
36
<object>::
 
37
        The name of the object to show.
 
38
        For a more complete list of ways to spell object names, see
 
39
        "SPECIFYING REVISIONS" section in gitlink:git-rev-parse[1].
28
40
 
29
41
include::pretty-formats.txt[]
30
42
 
 
43
 
 
44
EXAMPLES
 
45
--------
 
46
 
 
47
git show v1.0.0::
 
48
        Shows the tag `v1.0.0`, along with the object the tags
 
49
        points at.
 
50
 
 
51
git show v1.0.0^\{tree\}::
 
52
        Shows the tree pointed to by the tag `v1.0.0`.
 
53
 
 
54
git show next~10:Documentation/README::
 
55
        Shows the contents of the file `Documentation/README` as
 
56
        they were current in the 10th last commit of the branch
 
57
        `next`.
 
58
 
 
59
git show master:Makefile master:t/Makefile::
 
60
        Concatenates the contents of said Makefiles in the head
 
61
        of the branch `master`.
 
62
 
 
63
Discussion
 
64
----------
 
65
 
 
66
include::i18n.txt[]
 
67
 
31
68
Author
32
69
------
33
70
Written by Linus Torvalds <torvalds@osdl.org> and
34
 
Junio C Hamano <junkio@cox.net>
 
71
Junio C Hamano <junkio@cox.net>.  Significantly enhanced by
 
72
Johannes Schindelin <Johannes.Schindelin@gmx.de>.
35
73
 
36
74
 
37
75
Documentation