[PATCH] Update diff documentation.
[git.git] / Documentation / git-diff-files.txt
1 git-diff-files(1)
2 =================
3 v0.1, May 2005
4
5 NAME
6 ----
7 git-diff-files - Compares files in the working tree and the cache
8
9
10 SYNOPSIS
11 --------
12 'git-diff-files' [-p] [-q] [-r] [-z] [-R] [-B] [-M] [-C] [--find-copies-harder] [-O<orderfile>] [-S<string>] [--pickaxe-all] [<path>...]
13
14 DESCRIPTION
15 -----------
16 Compares the files in the working tree and the cache.  When paths
17 are specified, compares only those named paths.  Otherwise all
18 entries in the cache are compared.  The output format is the
19 same as "git-diff-cache" and "git-diff-tree".
20
21 OPTIONS
22 -------
23 -p::
24         generate patch (see section on generating patches).
25
26 -q::
27         Remain silent even on nonexisting files
28
29 -R::
30         Swap two inputs; that is, show differences from on-disk files
31         to cache contents.
32
33 -B::
34         Break complete rewrite changes into pairs of delete and create.
35
36 -M::
37         Detect renames.
38
39 -C::
40         Detect copies as well as renames.
41
42 --find-copies-harder::
43         By default, -C option finds copies only if the original
44         file of the copy was modified in the same changeset for
45         performance reasons.  This flag makes the command
46         inspect unmodified files as candidates for the source of
47         copy.  This is a very expensive operation for large
48         projects, so use it with caution.
49
50 -S<string>::
51         Look for differences that contains the change in <string>.
52
53 --pickaxe-all::
54         When -S finds a change, show all the changes in that
55         changeset, not just the files that contains the change
56         in <string>.
57
58 -O<orderfile>::
59         Output the patch in the order specified in the
60         <orderfile>, which has one shell glob pattern per line.
61
62 -r::
63         This flag does not mean anything.  It is there only to match
64         git-diff-tree.  Unlike git-diff-tree, git-diff-files always looks
65         at all the subdirectories.
66
67
68 Output format
69 -------------
70 include::diff-format.txt[]
71
72
73 Author
74 ------
75 Written by Linus Torvalds <torvalds@osdl.org>
76
77 Documentation
78 --------------
79 Documentation by David Greaves, Junio C Hamano and the git-list <git@vger.kernel.org>.
80
81 GIT
82 ---
83 Part of the link:git.html[git] suite
84