Code

allow for undeltified objects not to be reused
[git.git] / Documentation / git-log.txt
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 changes
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 -<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.
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].
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.
46 -p::
47         Show the change the commit introduces in a patch form.
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].
54 --decorate::
55     Print out the ref names of any commits that are shown.
57 <paths>...::
58         Show only commits that affect the specified paths.
61 Examples
62 --------
63 git log --no-merges::
65         Show the whole commit history, but skip any merges
67 git log v2.6.12.. include/scsi drivers/scsi::
69         Show all commits since version 'v2.6.12' that changed any file
70         in the include/scsi or drivers/scsi subdirectories
72 git log --since="2 weeks ago" \-- gitk::
74         Show the changes during the last two weeks to the file 'gitk'.
75         The "--" is necessary to avoid confusion with the *branch* named
76         'gitk'
78 git log -r --name-status release..test::
80         Show the commits that are in the "test" branch but not yet
81         in the "release" branch, along with the list of paths
82         each commit modifies.
84 Discussion
85 ----------
87 include::i18n.txt[]
90 Author
91 ------
92 Written by Linus Torvalds <torvalds@osdl.org>
94 Documentation
95 --------------
96 Documentation by David Greaves, Junio C Hamano and the git-list <git@vger.kernel.org>.
98 GIT
99 ---
100 Part of the gitlink:git[7] suite