Autogenerated man pages for v1.3.0-rc3-gd53352
[git.git] / man1 / git-whatchanged.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-WHATCHANGED" 1 "" "" ""
21 .SH NAME
22 git-whatchanged \- Show logs with difference each commit introduces
23 .SH "SYNOPSIS"
24
25
26 \fIgit\-whatchanged\fR <option>...
27
28 .SH "DESCRIPTION"
29
30
31 Shows commit logs and diff output each commit introduces\&. The command internally invokes \fIgit\-rev\-list\fR piped to \fIgit\-diff\-tree\fR, and takes command line options for both of these commands\&.
32
33
34 This manual page describes only the most frequently used options\&.
35
36 .SH "OPTIONS"
37
38 .TP
39 \-p
40 Show textual diffs, instead of the git internal diff output format that is useful only to tell the changed paths and their nature of changes\&.
41
42 .TP
43 \-\-max\-count=<n>
44 Limit output to <n> commits\&.
45
46 .TP
47 <since>\&.\&.<until>
48 Limit output to between the two named commits (bottom exclusive, top inclusive)\&.
49
50 .TP
51 \-r
52 Show git internal diff output, but for the whole tree, not just the top level\&.
53
54 .TP
55 \-\-pretty=<format>
56 Controls the output format for the commit logs\&. <format> can be one of \fIraw\fR, \fImedium\fR, \fIshort\fR, \fIfull\fR, and \fIoneline\fR\&.
57
58 .TP
59 \-m
60 By default, differences for merge commits are not shown\&. With this flag, show differences to that commit from all of its parents\&.
61
62 However, it is not very useful in general, although it \fIis\fR useful on a file\-by\-file basis\&.
63
64 .SH "EXAMPLES"
65
66 .TP
67 git\-whatchanged \-p v2\&.6\&.12\&.\&. include/scsi drivers/scsi
68 Show as patches the commits since version \fIv2\&.6\&.12\fR that changed any file in the include/scsi or drivers/scsi subdirectories
69
70 .TP
71 git\-whatchanged \-\-since="2 weeks ago" -- gitk
72 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 
73
74 .SH "AUTHOR"
75
76
77 Written by Linus Torvalds <torvalds@osdl\&.org> and Junio C Hamano <junkio@cox\&.net>
78
79 .SH "DOCUMENTATION"
80
81
82 Documentation by David Greaves, Junio C Hamano and the git\-list <git@vger\&.kernel\&.org>\&.
83
84 .SH "GIT"
85
86
87 Part of the \fBgit\fR(7) suite
88