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 | -------- |
Junio C Hamano | 15567bc | 2011-07-23 00:51:59 | [diff] [blame] | 11 | [verse] |
Junio C Hamano | fce7c7e | 2008-07-02 03:06:38 | [diff] [blame] | 12 | 'git whatchanged' <option>... |
Junio C Hamano | 1a4e841 | 2005-12-27 08:17:23 | [diff] [blame] | 13 | |
| 14 | DESCRIPTION |
| 15 | ----------- |
| 16 | Shows commit logs and diff output each commit introduces. The |
Junio C Hamano | 1aa40d2 | 2010-01-21 17:46:43 | [diff] [blame] | 17 | command internally invokes 'git rev-list' piped to |
| 18 | 'git diff-tree', and takes command line options for both of |
Junio C Hamano | 1a4e841 | 2005-12-27 08:17:23 | [diff] [blame] | 19 | these commands. |
| 20 | |
| 21 | This manual page describes only the most frequently used options. |
| 22 | |
| 23 | |
| 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. |
| 30 | |
Junio C Hamano | f9771f6 | 2007-01-17 17:42:30 | [diff] [blame] | 31 | -<n>:: |
Junio C Hamano | 1a4e841 | 2005-12-27 08:17:23 | [diff] [blame] | 32 | 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 Hamano | 1a4e841 | 2005-12-27 08:17:23 | [diff] [blame] | 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. |
Junio C Hamano | adeb899 | 2006-03-24 08:11:06 | [diff] [blame] | 46 | + |
| 47 | However, it is not very useful in general, although it |
| 48 | *is* useful on a file-by-file basis. |
Junio C Hamano | 1a4e841 | 2005-12-27 08:17:23 | [diff] [blame] | 49 | |
Junio C Hamano | 86bcccc | 2008-03-08 09:33:55 | [diff] [blame] | 50 | include::pretty-options.txt[] |
| 51 | |
| 52 | include::pretty-formats.txt[] |
| 53 | |
Junio C Hamano | 1a4e841 | 2005-12-27 08:17:23 | [diff] [blame] | 54 | Examples |
| 55 | -------- |
Junio C Hamano | 16ebcd0 | 2011-08-05 00:05:45 | [diff] [blame] | 56 | `git whatchanged -p v2.6.12.. include/scsi drivers/scsi`:: |
Junio C Hamano | 1a4e841 | 2005-12-27 08:17:23 | [diff] [blame] | 57 | |
| 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 | |
Junio C Hamano | b76a686 | 2012-05-02 22:02:46 | [diff] [blame] | 61 | `git whatchanged --since="2 weeks ago" -- gitk`:: |
Junio C Hamano | 1a4e841 | 2005-12-27 08:17:23 | [diff] [blame] | 62 | |
| 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 Hamano | 1a4e841 | 2005-12-27 08:17:23 | [diff] [blame] | 67 | GIT |
| 68 | --- |
Junio C Hamano | f7c042d | 2008-06-06 22:50:53 | [diff] [blame] | 69 | Part of the linkgit:git[1] suite |