Properly render asciidoc "callouts" in git man pages.
[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
17The command takes options applicable to the gitlink::git-rev-list[1]
18command to control what is shown and how, and options applicable to
19the gitlink::git-diff-tree[1] commands to control how the change
20each commit introduces are shown.
21
22This manual page describes only the most frequently used
23options.
3f971fc4 24
3f971fc4
JH
25
26OPTIONS
27-------
27dedf0c 28--pretty=<format>::
3f971fc4
JH
29 Controls the way the commit log is formatted.
30
31--max-count=<n>::
32 Limits the number of commits to show.
33
34<since>..<until>::
35 Show only commits between the named two commits.
36
e51c3b50
JH
37-p::
38 Show the change the commit introduces in a patch form.
39
40<paths>...::
41 Show only commits that affect the specified paths.
42
3f971fc4 43
bd663611
LT
44Examples
45--------
46git log --no-merges::
47
48 Show the whole commit history, but skip any merges
49
50git log v2.6.12.. include/scsi drivers/scsi::
51
52 Show all commits since version 'v2.6.12' that changed any file
53 in the include/scsi or drivers/scsi subdirectories
54
55git log --since="2 weeks ago" -- gitk::
56
57 Show the changes during the last two weeks to the file 'gitk'.
58 The "--" is necessary to avoid confusion with the *branch* named
59 'gitk'
60
e51c3b50
JH
61git log -r --name-status release..test::
62
63 Show the commits that are in the "test" branch but not yet
64 in the "release" branch, along with the list of paths
65 each commit modifies.
bd663611 66
3f971fc4
JH
67Author
68------
69Written by Linus Torvalds <torvalds@osdl.org>
70
71Documentation
72--------------
73Documentation by David Greaves, Junio C Hamano and the git-list <git@vger.kernel.org>.
74
75GIT
76---
a7154e91 77Part of the gitlink:git[7] suite
3f971fc4 78