blob: 6c8f510c3f6398630da248fd356a00f69a6d9471 [file] [log] [blame]
Junio C Hamano3f971fc2005-08-14 17:24:36 -07001git-whatchanged(1)
2==================
Junio C Hamano3f971fc2005-08-14 17:24:36 -07003
4NAME
5----
Fredrik Kuivinen7bd7f282006-03-09 17:24:50 +01006git-whatchanged - Show logs with difference each commit introduces
Junio C Hamano3f971fc2005-08-14 17:24:36 -07007
8
9SYNOPSIS
10--------
Martin von Zweigbergk7791a1d2011-07-01 22:38:26 -040011[verse]
Jonathan Niederb1889c32008-06-30 01:09:04 -050012'git whatchanged' <option>...
Junio C Hamano3f971fc2005-08-14 17:24:36 -070013
14DESCRIPTION
15-----------
16Shows commit logs and diff output each commit introduces. The
Thomas Rast0b444cd2010-01-10 00:33:00 +010017command internally invokes 'git rev-list' piped to
18'git diff-tree', and takes command line options for both of
Junio C Hamano3f971fc2005-08-14 17:24:36 -070019these commands.
20
21This manual page describes only the most frequently used options.
22
23
24OPTIONS
25-------
26-p::
27 Show textual diffs, instead of the git internal diff
28 output format that is useful only to tell the changed
29 paths and their nature of changes.
30
Junio C Hamano70551722007-01-17 01:11:56 -080031-<n>::
Junio C Hamano3f971fc2005-08-14 17:24:36 -070032 Limit output to <n> commits.
33
34<since>..<until>::
35 Limit output to between the two named commits (bottom
36 exclusive, top inclusive).
37
38-r::
39 Show git internal diff output, but for the whole tree,
40 not just the top level.
41
Junio C Hamano15fad5f2005-10-15 23:49:27 -070042-m::
43 By default, differences for merge commits are not shown.
44 With this flag, show differences to that commit from all
45 of its parents.
Francis Dalyb0d08a52006-03-22 09:53:57 +000046+
47However, it is not very useful in general, although it
48*is* useful on a file-by-file basis.
Junio C Hamano3f971fc2005-08-14 17:24:36 -070049
Denis Cheng53483372008-03-02 17:05:51 +080050include::pretty-options.txt[]
51
52include::pretty-formats.txt[]
53
Linus Torvaldsbd663612005-10-30 20:05:32 -080054Examples
55--------
Jeff King5d2fc912011-08-03 20:13:29 -060056`git whatchanged -p v2.6.12.. include/scsi drivers/scsi`::
Linus Torvaldsbd663612005-10-30 20:05:32 -080057
58 Show as patches the commits since version 'v2.6.12' that changed
59 any file in the include/scsi or drivers/scsi subdirectories
60
Jeff King6cf378f2012-04-26 04:51:57 -040061`git whatchanged --since="2 weeks ago" -- gitk`::
Linus Torvaldsbd663612005-10-30 20:05:32 -080062
63 Show the changes during the last two weeks to the file 'gitk'.
64 The "--" is necessary to avoid confusion with the *branch* named
65 'gitk'
66
Junio C Hamano3f971fc2005-08-14 17:24:36 -070067GIT
68---
Christian Couder9e1f0a82008-06-06 09:07:32 +020069Part of the linkgit:git[1] suite