Document git log --abbrev-commit, as a kind of pretty option
[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
adb7ba6b 30-<n>::
3f971fc4
JH
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.
41a5564e
SP
37 For a more complete list of ways to spell <since>
38 and <until>, see "SPECIFYING REVISIONS" section in
39 gitlink:git-rev-parse[1].
3f971fc4 40
89d58923
JH
41--first-parent::
42 Follow only the first parent commit upon seeing a merge
43 commit. This option gives a better overview of the
44 evolution of a particular branch.
45
e51c3b50
JH
46-p::
47 Show the change the commit introduces in a patch form.
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.
52 See also gitlink:git-reflog[1].
53
56822cc9 54--decorate::
ef3cb65c 55 Print out the ref names of any commits that are shown.
56822cc9 56
e51c3b50
JH
57<paths>...::
58 Show only commits that affect the specified paths.
59
3f971fc4 60
331b51d2
JN
61include::pretty-formats.txt[]
62
63
bd663611
LT
64Examples
65--------
66git log --no-merges::
67
68 Show the whole commit history, but skip any merges
69
70git log v2.6.12.. include/scsi drivers/scsi::
71
72 Show all commits since version 'v2.6.12' that changed any file
73 in the include/scsi or drivers/scsi subdirectories
74
e994004f 75git log --since="2 weeks ago" \-- gitk::
bd663611
LT
76
77 Show the changes during the last two weeks to the file 'gitk'.
78 The "--" is necessary to avoid confusion with the *branch* named
79 'gitk'
80
e51c3b50
JH
81git log -r --name-status release..test::
82
83 Show the commits that are in the "test" branch but not yet
84 in the "release" branch, along with the list of paths
85 each commit modifies.
bd663611 86
5dc7bcc2
JH
87Discussion
88----------
89
90include::i18n.txt[]
91
92
3f971fc4
JH
93Author
94------
95Written by Linus Torvalds <torvalds@osdl.org>
96
97Documentation
98--------------
99Documentation by David Greaves, Junio C Hamano and the git-list <git@vger.kernel.org>.
100
101GIT
102---
a7154e91 103Part of the gitlink:git[7] suite