X-Git-Url: https://git.octo.it/?a=blobdiff_plain;f=Documentation%2Fdiff-options.txt;h=f523ec2fbea9a129294b960461c82382b41ac92d;hb=1a82e79315ed633f6b0b1fc4076054950c5380d3;hp=b28496e5c8290aa2b9b3e254f332d2b167a55ac6;hpb=b30245c8e92ecaf8fb877189d7620a5a9a205120;p=git.git diff --git a/Documentation/diff-options.txt b/Documentation/diff-options.txt index b28496e5..f523ec2f 100644 --- a/Documentation/diff-options.txt +++ b/Documentation/diff-options.txt @@ -4,10 +4,18 @@ -u:: Synonym for "-p". --r:: - Look recursively in subdirectories; this flag does not - mean anything to commands other than "git-diff-tree"; - other diff commands always look at all the subdirectories. +--patch-with-raw:: + Generate patch but keep also the default raw diff output. + +--stat:: + Generate a diffstat instead of a patch. + +--summary:: + Output a condensed summary of extended header information + such as creations, renames and mode changes. + +--patch-with-stat:: + Generate patch and prepend its diffstat. -z:: \0 line termination on output @@ -15,8 +23,21 @@ --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. + +--full-index:: + Instead of the first handful characters, show full + object name of pre- and post-image blob on the "index" + line when generating a patch format output. + +--abbrev[=]:: + Instead of showing the full 40-byte hexadecimal object + name in diff-raw format output and diff-tree header + lines, show only handful hexdigits prefix. This is + independent of --full-index option above, which controls + the diff-patch output format. Non default number of + digits can be specified with --abbrev=. -B:: Break complete rewrite changes into pairs of delete and create. @@ -27,27 +48,51 @@ -C:: Detect copies as well as renames. +--diff-filter=[ACDMRTUXB*]:: + Select only files that are Added (`A`), Copied (`C`), + Deleted (`D`), Modified (`M`), Renamed (`R`), have their + type (mode) changed (`T`), are Unmerged (`U`), are + Unknown (`X`), or have had their pairing Broken (`B`). + Any combination of the filter characters may be used. + When `*` (All-or-none) is added to the combination, all + paths are selected if there is any file that matches + other criteria in the comparison; if there is no file + that matches other criteria, nothing is selected. + --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:: + -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:: - Look for differences that contains the change in . + Look for differences that contain the change in . --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 . +--pickaxe-regex:: + Make the not a plain string but an extended POSIX + regex to match. + -O:: Output the patch in the order specified in the , which has one shell glob pattern per line. -R:: - Swap two inputs; that is, show differences from cache or + Swap two inputs; that is, show differences from index or on-disk file to tree contents. +For more detailed explanation on these common options, see also +link:diffcore.html[diffcore documentation].