Autogenerated man pages for v1.3.0-rc3-g170a
[git.git] / man1 / git-log.1
1 .\"Generated by db2man.xsl. Don't modify this, modify the source.
2 .de Sh \" Subsection
3 .br
4 .if t .Sp
5 .ne 5
6 .PP
7 \fB\\$1\fR
8 .PP
9 ..
10 .de Sp \" Vertical space (when we can't use .PP)
11 .if t .sp .5v
12 .if n .sp
13 ..
14 .de Ip \" List item
15 .br
16 .ie \\n(.$>=3 .ne \\$3
17 .el .ne 3
18 .IP "\\$1" \\$2
19 ..
20 .TH "GIT-LOG" 1 "" "" ""
21 .SH NAME
22 git-log \- Show commit logs
23 .SH "SYNOPSIS"
24
25
26 \fIgit\-log\fR <option>...
27
28 .SH "DESCRIPTION"
29
30
31 Shows the commit logs\&.
32
33
34 The command takes options applicable to the \fB:git\-rev\-list\fR(1) command to control what is shown and how, and options applicable to the \fB:git\-diff\-tree\fR(1) commands to control how the change each commit introduces are shown\&.
35
36
37 This manual page describes only the most frequently used options\&.
38
39 .SH "OPTIONS"
40
41 .TP
42 \-\-pretty=<format>
43 Controls the way the commit log is formatted\&.
44
45 .TP
46 \-\-max\-count=<n>
47 Limits the number of commits to show\&.
48
49 .TP
50 <since>\&.\&.<until>
51 Show only commits between the named two commits\&.
52
53 .TP
54 \-p
55 Show the change the commit introduces in a patch form\&.
56
57 .TP
58 <paths>...
59 Show only commits that affect the specified paths\&.
60
61 .SH "EXAMPLES"
62
63 .TP
64 git log \-\-no\-merges
65 Show the whole commit history, but skip any merges
66
67 .TP
68 git log v2\&.6\&.12\&.\&. include/scsi drivers/scsi
69 Show all commits since version \fIv2\&.6\&.12\fR that changed any file in the include/scsi or drivers/scsi subdirectories
70
71 .TP
72 git log \-\-since="2 weeks ago" -- gitk
73 Show the changes during the last two weeks to the file \fIgitk\fR\&. The "\-\-" is necessary to avoid confusion with the \fIbranch\fR named \fIgitk\fR 
74
75 .TP
76 git log \-r \-\-name\-status release\&.\&.test
77 Show the commits that are in the "test" branch but not yet in the "release" branch, along with the list of paths each commit modifies\&.
78
79 .SH "AUTHOR"
80
81
82 Written by Linus Torvalds <torvalds@osdl\&.org>
83
84 .SH "DOCUMENTATION"
85
86
87 Documentation by David Greaves, Junio C Hamano and the git\-list <git@vger\&.kernel\&.org>\&.
88
89 .SH "GIT"
90
91
92 Part of the \fBgit\fR(7) suite
93