Convert output messages in merge-recursive to past tense.
[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
aa6bf0eb 19the gitlink:git-diff-tree[1] commands to control how the change
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
CR
27
28include::pretty-formats.txt[]
3f971fc4
JH
29
30--max-count=<n>::
31 Limits the number of commits to show.
32
33<since>..<until>::
99e09cce
JH
34 Show only commits between the named two commits. When
35 either <since> or <until> is omitted, it defaults to
36 `HEAD`, i.e. the tip of the current branch.
3f971fc4 37
e51c3b50
JH
38-p::
39 Show the change the commit introduces in a patch form.
40
41<paths>...::
42 Show only commits that affect the specified paths.
43
3f971fc4 44
bd663611
LT
45Examples
46--------
47git log --no-merges::
48
49 Show the whole commit history, but skip any merges
50
51git log v2.6.12.. include/scsi drivers/scsi::
52
53 Show all commits since version 'v2.6.12' that changed any file
54 in the include/scsi or drivers/scsi subdirectories
55
e994004f 56git log --since="2 weeks ago" \-- gitk::
bd663611
LT
57
58 Show the changes during the last two weeks to the file 'gitk'.
59 The "--" is necessary to avoid confusion with the *branch* named
60 'gitk'
61
e51c3b50
JH
62git log -r --name-status release..test::
63
64 Show the commits that are in the "test" branch but not yet
65 in the "release" branch, along with the list of paths
66 each commit modifies.
bd663611 67
5dc7bcc2
JH
68Discussion
69----------
70
71include::i18n.txt[]
72
73
3f971fc4
JH
74Author
75------
76Written by Linus Torvalds <torvalds@osdl.org>
77
78Documentation
79--------------
80Documentation by David Greaves, Junio C Hamano and the git-list <git@vger.kernel.org>.
81
82GIT
83---
a7154e91 84Part of the gitlink:git[7] suite
3f971fc4 85