Merge branch 'cb/maint-orphan-merge-noclobber'
[git/kirr.git] / Documentation / git-whatchanged.txt
blobea753cdafce66c33a0a0e8d9a52d75c974194ad5
1 git-whatchanged(1)
2 ==================
4 NAME
5 ----
6 git-whatchanged - Show logs with difference each commit introduces
9 SYNOPSIS
10 --------
11 'git whatchanged' <option>...
13 DESCRIPTION
14 -----------
15 Shows commit logs and diff output each commit introduces.  The
16 command internally invokes 'git rev-list' piped to
17 'git diff-tree', and takes command line options for both of
18 these commands.
20 This manual page describes only the most frequently used options.
23 OPTIONS
24 -------
25 -p::
26         Show textual diffs, instead of the git internal diff
27         output format that is useful only to tell the changed
28         paths and their nature of changes.
30 -<n>::
31         Limit output to <n> commits.
33 <since>..<until>::
34         Limit output to between the two named commits (bottom
35         exclusive, top inclusive).
37 -r::
38         Show git internal diff output, but for the whole tree,
39         not just the top level.
41 -m::
42         By default, differences for merge commits are not shown.
43         With this flag, show differences to that commit from all
44         of its parents.
46 However, it is not very useful in general, although it
47 *is* useful on a file-by-file basis.
49 include::pretty-options.txt[]
51 include::pretty-formats.txt[]
53 Examples
54 --------
55 git whatchanged -p v2.6.12.. include/scsi drivers/scsi::
57         Show as patches the commits since version 'v2.6.12' that changed
58         any file in the include/scsi or drivers/scsi subdirectories
60 git whatchanged --since="2 weeks ago" \-- gitk::
62         Show the changes during the last two weeks to the file 'gitk'.
63         The "--" is necessary to avoid confusion with the *branch* named
64         'gitk'
67 Author
68 ------
69 Written by Linus Torvalds <torvalds@osdl.org> and
70 Junio C Hamano <gitster@pobox.com>
73 Documentation
74 --------------
75 Documentation by David Greaves, Junio C Hamano and the git-list <git@vger.kernel.org>.
77 GIT
78 ---
79 Part of the linkgit:git[1] suite