Documentation / git-diff-tree.txton commit gitsubmodules: align html and nroff lists (8e9fe16)
   1git-diff-tree(1)
   2================
   3
   4NAME
   5----
   6git-diff-tree - Compares the content and mode of blobs found via two tree objects
   7
   8
   9SYNOPSIS
  10--------
  11[verse]
  12'git diff-tree' [--stdin] [-m] [-s] [-v] [--no-commit-id] [--pretty]
  13              [-t] [-r] [-c | --cc] [--root] [<common diff options>]
  14              <tree-ish> [<tree-ish>] [<path>...]
  15
  16DESCRIPTION
  17-----------
  18Compares the content and mode of the blobs found via two tree objects.
  19
  20If there is only one <tree-ish> given, the commit is compared with its parents
  21(see --stdin below).
  22
  23Note that 'git diff-tree' can use the tree encapsulated in a commit object.
  24
  25OPTIONS
  26-------
  27include::diff-options.txt[]
  28
  29<tree-ish>::
  30        The id of a tree object.
  31
  32<path>...::
  33        If provided, the results are limited to a subset of files
  34        matching one of the provided pathspecs.
  35
  36-r::
  37        recurse into sub-trees
  38
  39-t::
  40        show tree entry itself as well as subtrees.  Implies -r.
  41
  42--root::
  43        When `--root` is specified the initial commit will be shown as a big
  44        creation event. This is equivalent to a diff against the NULL tree.
  45
  46--stdin::
  47        When `--stdin` is specified, the command does not take
  48        <tree-ish> arguments from the command line.  Instead, it
  49        reads lines containing either two <tree>, one <commit>, or a
  50        list of <commit> from its standard input.  (Use a single space
  51        as separator.)
  52+
  53When two trees are given, it compares the first tree with the second.
  54When a single commit is given, it compares the commit with its
  55parents.  The remaining commits, when given, are used as if they are
  56parents of the first commit.
  57+
  58When comparing two trees, the ID of both trees (separated by a space
  59and terminated by a newline) is printed before the difference.  When
  60comparing commits, the ID of the first (or only) commit, followed by a
  61newline, is printed.
  62+
  63The following flags further affect the behavior when comparing
  64commits (but not trees).
  65
  66-m::
  67        By default, 'git diff-tree --stdin' does not show
  68        differences for merge commits.  With this flag, it shows
  69        differences to that commit from all of its parents. See
  70        also `-c`.
  71
  72-s::
  73        By default, 'git diff-tree --stdin' shows differences,
  74        either in machine-readable form (without `-p`) or in patch
  75        form (with `-p`).  This output can be suppressed.  It is
  76        only useful with `-v` flag.
  77
  78-v::
  79        This flag causes 'git diff-tree --stdin' to also show
  80        the commit message before the differences.
  81
  82include::pretty-options.txt[]
  83
  84--no-commit-id::
  85        'git diff-tree' outputs a line with the commit ID when
  86        applicable.  This flag suppressed the commit ID output.
  87
  88-c::
  89        This flag changes the way a merge commit is displayed
  90        (which means it is useful only when the command is given
  91        one <tree-ish>, or `--stdin`).  It shows the differences
  92        from each of the parents to the merge result simultaneously
  93        instead of showing pairwise diff between a parent and the
  94        result one at a time (which is what the `-m` option does).
  95        Furthermore, it lists only files which were modified
  96        from all parents.
  97
  98--cc::
  99        This flag changes the way a merge commit patch is displayed,
 100        in a similar way to the `-c` option. It implies the `-c`
 101        and `-p` options and further compresses the patch output
 102        by omitting uninteresting hunks whose the contents in the parents
 103        have only two variants and the merge result picks one of them
 104        without modification.  When all hunks are uninteresting, the commit
 105        itself and the commit log message is not shown, just like in any other
 106        "empty diff" case.
 107
 108--always::
 109        Show the commit itself and the commit log message even
 110        if the diff itself is empty.
 111
 112
 113include::pretty-formats.txt[]
 114include::diff-format.txt[]
 115
 116GIT
 117---
 118Part of the linkgit:git[1] suite