manpages: italicize command names
[git/git.git] / Documentation / git-log.txt
CommitLineData
215a7ad1
JH
1git-log(1)
2==========
3f971fc4
JH
3
4NAME
5----
215a7ad1 6git-log - Show commit logs
3f971fc4
JH
7
8
9SYNOPSIS
10--------
b1889c36 11'git log' <option>...
3f971fc4
JH
12
13DESCRIPTION
14-----------
e51c3b50
JH
15Shows the commit logs.
16
483bc4f0 17The command takes options applicable to the `git-rev-list`
e51c3b50 18command to control what is shown and how, and options applicable to
483bc4f0 19the `git-diff-*` commands to control how the changes
e51c3b50
JH
20each commit introduces are shown.
21
3f971fc4
JH
22
23OPTIONS
24-------
5d1faf87 25
272bd3cf
MV
26:git-log: 1
27include::diff-options.txt[]
28
adb7ba6b 29-<n>::
3f971fc4
JH
30 Limits the number of commits to show.
31
32<since>..<until>::
99e09cce
JH
33 Show only commits between the named two commits. When
34 either <since> or <until> is omitted, it defaults to
35 `HEAD`, i.e. the tip of the current branch.
41a5564e
SP
36 For a more complete list of ways to spell <since>
37 and <until>, see "SPECIFYING REVISIONS" section in
5162e697 38 linkgit:git-rev-parse[1].
3f971fc4 39
56822cc9 40--decorate::
ef3cb65c 41 Print out the ref names of any commits that are shown.
56822cc9 42
2e88c266
JN
43--full-diff::
44 Without this flag, "git log -p <paths>..." shows commits that
45 touch the specified paths, and diffs about the same specified
46 paths. With this, the full diff is shown for commits that touch
47 the specified paths; this means that "<paths>..." limits only
48 commits, and doesn't limit diff for those commits.
49
4f50f6a9
SW
50--follow::
51 Continue listing the history of a file beyond renames.
52
9fa3465d
MC
53--log-size::
54 Before the log message print out its size in bytes. Intended
55 mainly for porcelain tools consumption. If git is unable to
56 produce a valid value size is set to zero.
57 Note that only message is considered, if also a diff is shown
58 its size is not included.
59
e51c3b50
JH
60<paths>...::
61 Show only commits that affect the specified paths.
62
3f971fc4 63
fdcf39e5
MV
64include::rev-list-options.txt[]
65
331b51d2
JN
66include::pretty-formats.txt[]
67
272bd3cf 68include::diff-generate-patch.txt[]
331b51d2 69
bd663611
LT
70Examples
71--------
72git log --no-merges::
73
74 Show the whole commit history, but skip any merges
75
76git log v2.6.12.. include/scsi drivers/scsi::
77
78 Show all commits since version 'v2.6.12' that changed any file
79 in the include/scsi or drivers/scsi subdirectories
80
e994004f 81git log --since="2 weeks ago" \-- gitk::
bd663611
LT
82
83 Show the changes during the last two weeks to the file 'gitk'.
84 The "--" is necessary to avoid confusion with the *branch* named
85 'gitk'
86
170c0438 87git log --name-status release..test::
e51c3b50
JH
88
89 Show the commits that are in the "test" branch but not yet
90 in the "release" branch, along with the list of paths
91 each commit modifies.
bd663611 92
4f50f6a9
SW
93git log --follow builtin-rev-list.c::
94
95 Shows the commits that changed builtin-rev-list.c, including
96 those commits that occurred before the file was given its
97 present name.
98
5dc7bcc2
JH
99Discussion
100----------
101
102include::i18n.txt[]
103
104
3f971fc4
JH
105Author
106------
107Written by Linus Torvalds <torvalds@osdl.org>
108
109Documentation
110--------------
111Documentation by David Greaves, Junio C Hamano and the git-list <git@vger.kernel.org>.
112
113GIT
114---
9e1f0a85 115Part of the linkgit:git[1] suite