Add git-init documentation.
[git/dkf.git] / Documentation / git-log.txt
blobe9f746bbd4cebde9d8f5b90dd8fea6a2a610b140
1 git-log(1)
2 ==========
4 NAME
5 ----
6 git-log - Show commit logs
9 SYNOPSIS
10 --------
11 'git-log' <option>...
13 DESCRIPTION
14 -----------
15 Shows the commit logs.
17 The command takes options applicable to the gitlink:git-rev-list[1]
18 command to control what is shown and how, and options applicable to
19 the gitlink:git-diff-tree[1] commands to control how the change
20 each commit introduces are shown.
22 This manual page describes only the most frequently used options.
25 OPTIONS
26 -------
28 include::pretty-formats.txt[]
30 --max-count=<n>::
31         Limits the number of commits to show.
33 <since>..<until>::
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.
38 -p::
39         Show the change the commit introduces in a patch form.
41 <paths>...::
42         Show only commits that affect the specified paths.
45 Examples
46 --------
47 git log --no-merges::
49         Show the whole commit history, but skip any merges
51 git log v2.6.12.. include/scsi drivers/scsi::
53         Show all commits since version 'v2.6.12' that changed any file
54         in the include/scsi or drivers/scsi subdirectories
56 git log --since="2 weeks ago" \-- gitk::
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'
62 git log -r --name-status release..test::
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.
68 Discussion
69 ----------
71 include::i18n.txt[]
74 Author
75 ------
76 Written by Linus Torvalds <torvalds@osdl.org>
78 Documentation
79 --------------
80 Documentation by David Greaves, Junio C Hamano and the git-list <git@vger.kernel.org>.
82 GIT
83 ---
84 Part of the gitlink:git[7] suite