Junio C Hamano | 1a4e841 | 2005-12-27 08:17:23 | [diff] [blame] | 1 | git-whatchanged(1) |
| 2 | ================== |
| 3 | |
| 4 | NAME |
| 5 | ---- |
Junio C Hamano | 0107892 | 2006-03-10 00:31:47 | [diff] [blame] | 6 | git-whatchanged - Show logs with difference each commit introduces |
Junio C Hamano | 1a4e841 | 2005-12-27 08:17:23 | [diff] [blame] | 7 | |
| 8 | |
| 9 | SYNOPSIS |
| 10 | -------- |
| 11 | 'git-whatchanged' <option>... |
| 12 | |
| 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. |
| 19 | |
| 20 | This manual page describes only the most frequently used options. |
| 21 | |
| 22 | |
| 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. |
| 29 | |
Junio C Hamano | f9771f6 | 2007-01-17 17:42:30 | [diff] [blame] | 30 | -<n>:: |
Junio C Hamano | 1a4e841 | 2005-12-27 08:17:23 | [diff] [blame] | 31 | Limit output to <n> commits. |
| 32 | |
| 33 | <since>..<until>:: |
| 34 | Limit output to between the two named commits (bottom |
| 35 | exclusive, top inclusive). |
| 36 | |
| 37 | -r:: |
| 38 | Show git internal diff output, but for the whole tree, |
| 39 | not just the top level. |
| 40 | |
Junio C Hamano | 1a4e841 | 2005-12-27 08:17:23 | [diff] [blame] | 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. |
Junio C Hamano | adeb899 | 2006-03-24 08:11:06 | [diff] [blame] | 45 | + |
| 46 | However, it is not very useful in general, although it |
| 47 | *is* useful on a file-by-file basis. |
Junio C Hamano | 1a4e841 | 2005-12-27 08:17:23 | [diff] [blame] | 48 | |
Junio C Hamano | 86bcccc | 2008-03-08 09:33:55 | [diff] [blame^] | 49 | include::pretty-options.txt[] |
| 50 | |
| 51 | include::pretty-formats.txt[] |
| 52 | |
Junio C Hamano | 1a4e841 | 2005-12-27 08:17:23 | [diff] [blame] | 53 | Examples |
| 54 | -------- |
| 55 | git-whatchanged -p v2.6.12.. include/scsi drivers/scsi:: |
| 56 | |
| 57 | Show as patches the commits since version 'v2.6.12' that changed |
| 58 | any file in the include/scsi or drivers/scsi subdirectories |
| 59 | |
Junio C Hamano | 1bb569e | 2006-05-05 23:14:25 | [diff] [blame] | 60 | git-whatchanged --since="2 weeks ago" \-- gitk:: |
Junio C Hamano | 1a4e841 | 2005-12-27 08:17:23 | [diff] [blame] | 61 | |
| 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' |
| 65 | |
| 66 | |
| 67 | Author |
| 68 | ------ |
| 69 | Written by Linus Torvalds <torvalds@osdl.org> and |
| 70 | Junio C Hamano <junkio@cox.net> |
| 71 | |
| 72 | |
| 73 | Documentation |
| 74 | -------------- |
| 75 | Documentation by David Greaves, Junio C Hamano and the git-list <git@vger.kernel.org>. |
| 76 | |
| 77 | GIT |
| 78 | --- |
Junio C Hamano | 35738e8 | 2008-01-07 07:55:46 | [diff] [blame] | 79 | Part of the linkgit:git[7] suite |