Documentation: fix "gitlink::foobar[s]"
[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
25db465a
JH
46 commit. This option can give a better overview when
47 viewing the evolution of a particular topic branch,
48 because merges into a topic branch tend to be only about
49 adjusting to updated upstream from time to time, and
50 this option allows you to ignore the individual commits
51 brought in to your history by such a merge.
89d58923 52
5f2e1df5
AR
53-g, \--walk-reflogs::
54 Show commits as they were recorded in the reflog. The log contains
55 a record about how the tip of a reference was changed.
d56651c0 56 Cannot be combined with --reverse.
5f2e1df5
AR
57 See also gitlink:git-reflog[1].
58
56822cc9 59--decorate::
ef3cb65c 60 Print out the ref names of any commits that are shown.
56822cc9 61
2e88c266
JN
62--full-diff::
63 Without this flag, "git log -p <paths>..." shows commits that
64 touch the specified paths, and diffs about the same specified
65 paths. With this, the full diff is shown for commits that touch
66 the specified paths; this means that "<paths>..." limits only
67 commits, and doesn't limit diff for those commits.
68
4f50f6a9
SW
69--follow::
70 Continue listing the history of a file beyond renames.
71
9fa3465d
MC
72--log-size::
73 Before the log message print out its size in bytes. Intended
74 mainly for porcelain tools consumption. If git is unable to
75 produce a valid value size is set to zero.
76 Note that only message is considered, if also a diff is shown
77 its size is not included.
78
e51c3b50
JH
79<paths>...::
80 Show only commits that affect the specified paths.
81
3f971fc4 82
331b51d2
JN
83include::pretty-formats.txt[]
84
272bd3cf 85include::diff-generate-patch.txt[]
331b51d2 86
bd663611
LT
87Examples
88--------
89git log --no-merges::
90
91 Show the whole commit history, but skip any merges
92
93git log v2.6.12.. include/scsi drivers/scsi::
94
95 Show all commits since version 'v2.6.12' that changed any file
96 in the include/scsi or drivers/scsi subdirectories
97
e994004f 98git log --since="2 weeks ago" \-- gitk::
bd663611
LT
99
100 Show the changes during the last two weeks to the file 'gitk'.
101 The "--" is necessary to avoid confusion with the *branch* named
102 'gitk'
103
170c0438 104git log --name-status release..test::
e51c3b50
JH
105
106 Show the commits that are in the "test" branch but not yet
107 in the "release" branch, along with the list of paths
108 each commit modifies.
bd663611 109
4f50f6a9
SW
110git log --follow builtin-rev-list.c::
111
112 Shows the commits that changed builtin-rev-list.c, including
113 those commits that occurred before the file was given its
114 present name.
115
5dc7bcc2
JH
116Discussion
117----------
118
119include::i18n.txt[]
120
121
3f971fc4
JH
122Author
123------
124Written by Linus Torvalds <torvalds@osdl.org>
125
126Documentation
127--------------
128Documentation by David Greaves, Junio C Hamano and the git-list <git@vger.kernel.org>.
129
130GIT
131---
a7154e91 132Part of the gitlink:git[7] suite