Documentation / git-whatchanged.txton commit Merge branch 'fc/show-non-empty-errors-in-test' (01c0615)
   1git-whatchanged(1)
   2==================
   3
   4NAME
   5----
   6git-whatchanged - Show logs with difference each commit introduces
   7
   8
   9SYNOPSIS
  10--------
  11[verse]
  12'git whatchanged' <option>...
  13
  14DESCRIPTION
  15-----------
  16Shows commit logs and diff output each commit introduces.  The
  17command internally invokes 'git rev-list' piped to
  18'git diff-tree', and takes command line options for both of
  19these commands.
  20
  21This manual page describes only the most frequently used options.
  22
  23
  24OPTIONS
  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+
  47However, it is not very useful in general, although it
  48*is* useful on a file-by-file basis.
  49
  50include::pretty-options.txt[]
  51
  52include::pretty-formats.txt[]
  53
  54Examples
  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
  67GIT
  68---
  69Part of the linkgit:git[1] suite