Documentation / git-diff-files.txton commit glossary: Add definitions for dangling and unreachable objects (2aa54fa)
   1git-diff-files(1)
   2=================
   3
   4NAME
   5----
   6git-diff-files - Compares files in the working tree and the index
   7
   8
   9SYNOPSIS
  10--------
  11'git-diff-files' [-q] [-0|-1|-2|-3|-c|--cc] [<common diff options>] [<path>...]
  12
  13DESCRIPTION
  14-----------
  15Compares the files in the working tree and the index.  When paths
  16are specified, compares only those named paths.  Otherwise all
  17entries in the index are compared.  The output format is the
  18same as "git-diff-index" and "git-diff-tree".
  19
  20OPTIONS
  21-------
  22include::diff-options.txt[]
  23
  24-1 -2 -3 or --base --ours --theirs, and -0::
  25        Diff against the "base" version, "our branch" or "their
  26        branch" respectively.  With these options, diffs for
  27        merged entries are not shown.
  28+
  29The default is to diff against our branch (-2) and the 
  30cleanly resolved paths.  The option -0 can be given to
  31omit diff output for unmerged entries and just show "Unmerged".
  32
  33-c,--cc::
  34        This compares stage 2 (our branch), stage 3 (their
  35        branch) and the working tree file and outputs a combined
  36        diff, similar to the way 'diff-tree' shows a merge
  37        commit with these flags.
  38
  39-q::
  40        Remain silent even on nonexistent files
  41
  42Output format
  43-------------
  44include::diff-format.txt[]
  45
  46
  47Author
  48------
  49Written by Linus Torvalds <torvalds@osdl.org>
  50
  51Documentation
  52--------------
  53Documentation by David Greaves, Junio C Hamano and the git-list <git@vger.kernel.org>.
  54
  55GIT
  56---
  57Part of the gitlink:git[7] suite
  58