Merge branch 'master' of git://git.kernel.org/pub/scm/git/git
[git/jnareb-git.git] / Documentation / git-whatchanged.txt
blobc600b61e2b62013366476807c733837c0e854165
1 git-whatchanged(1)
2 ==================
4 NAME
5 ----
6 git-whatchanged - Show logs with difference each commit introduces
9 SYNOPSIS
10 --------
11 [verse]
12 'git whatchanged' <option>...
14 DESCRIPTION
15 -----------
16 Shows commit logs and diff output each commit introduces.  The
17 command internally invokes 'git rev-list' piped to
18 'git diff-tree', and takes command line options for both of
19 these commands.
21 This manual page describes only the most frequently used options.
24 OPTIONS
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.
31 -<n>::
32         Limit output to <n> commits.
34 <since>..<until>::
35         Limit output to between the two named commits (bottom
36         exclusive, top inclusive).
38 -r::
39         Show Git internal diff output, but for the whole tree,
40         not just the top level.
42 -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.
47 However, it is not very useful in general, although it
48 *is* useful on a file-by-file basis.
50 include::pretty-options.txt[]
52 include::pretty-formats.txt[]
54 Examples
55 --------
56 `git whatchanged -p v2.6.12.. include/scsi drivers/scsi`::
58         Show as patches the commits since version 'v2.6.12' that changed
59         any file in the include/scsi or drivers/scsi subdirectories
61 `git whatchanged --since="2 weeks ago" -- gitk`::
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'
67 GIT
68 ---
69 Part of the linkgit:git[1] suite