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