Update howto using-topic-branches
[gitweb.git] / Documentation / diff-options.txt
index 58b9c46c20a6998e5b5abb3e1e396f51d820ace1..32005b03f3bee40413d7ff0d33e143de85b194c6 100644 (file)
@@ -4,19 +4,14 @@
 -u::
        Synonym for "-p".
 
--r::
-       Look recursivelly in subdirectories; this flag does not
-       mean anything to commands other than "git-diff-tree";
-       other commands always looks at all the subdirectories.
-
 -z::
        \0 line termination on output
 
 --name-only::
        Show only names of changed files.
 
---name-only-z::
-       Same as --name-only, but terminate lines with NUL.
+--name-status::
+       Show only names and status of changed files.
 
 -B::
        Break complete rewrite changes into pairs of delete and create.
        Detect copies as well as renames.
 
 --find-copies-harder::
-       By default, -C option finds copies only if the original
-       file of the copy was modified in the same changeset for
-       performance reasons.  This flag makes the command
+       For performance reasons, by default, -C option finds copies only 
+       if the original file of the copy was modified in the same 
+       changeset.  This flag makes the command
        inspect unmodified files as candidates for the source of
        copy.  This is a very expensive operation for large
        projects, so use it with caution.
 
+-l<num>::
+       -M and -C options require O(n^2) processing time where n
+       is the number of potential rename/copy targets.  This
+       option prevents rename/copy detection from running if
+       the number of rename/copy targets exceeds the specified
+       number.
+
 -S<string>::
-       Look for differences that contains the change in <string>.
+       Look for differences that contain the change in <string>.
 
 --pickaxe-all::
        When -S finds a change, show all the changes in that
-       changeset, not just the files that contains the change
+       changeset, not just the files that contain the change
        in <string>.
 
 -O<orderfile>::
@@ -51,3 +53,5 @@
        Swap two inputs; that is, show differences from cache or
        on-disk file to tree contents.
 
+For more detailed explanation on these common options, see also
+link:diffcore.html[diffcore documentation].