Documentation/git-whatchanged.txt

   1 git-whatchanged(1)
   2 ==================
   3
   4 NAME
   5 ----
   6 git-whatchanged - Show logs with difference each commit introduces
   7
   8
   9 SYNOPSIS
  10 --------
  11 [verse]
  12 'git whatchanged' <option>...
  13
  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.
  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
  31 -<n>::
  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
  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.
  46 +
  47 However, it is not very useful in general, although it
  48 *is* useful on a file-by-file basis.
  49
  50 include::pretty-options.txt[]
  51
  52 include::pretty-formats.txt[]
  53
  54 Examples
  55 --------
  56 `git whatchanged -p v2.6.12.. include/scsi drivers/scsi`::
  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
  61 `git whatchanged --since="2 weeks ago" \-- gitk`::
  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
  67 GIT
  68 ---
  69 Part of the linkgit:git[1] suite