Merge branch 'al/ansi-color'
[gitweb.git] / Documentation / diff-options.txt
index 1f8ce979bbb73c7caf28bc6bca3283254470bb1c..813a7b11b99d51d3014f854770384ed4fc247c9f 100644 (file)
@@ -36,7 +36,7 @@ endif::git-format-patch[]
 --patch-with-raw::
        Synonym for "-p --raw".
 
---patience:
+--patience::
        Generate a diff using the "patience diff" algorithm.
 
 --stat[=width[,name-width]]::
@@ -94,8 +94,22 @@ endif::git-format-patch[]
        Turn off colored diff, even when the configuration file
        gives the default to color output.
 
---color-words::
-       Show colored word diff, i.e. color words which have changed.
+--color-words[=<regex>]::
+       Show colored word diff, i.e., color words which have changed.
+       By default, words are separated by whitespace.
++
+When a <regex> is specified, every non-overlapping match of the
+<regex> is considered a word.  Anything between these matches is
+considered whitespace and ignored(!) for the purposes of finding
+differences.  You may want to append `|[^[:space:]]` to your regular
+expression to make sure that it matches all non-whitespace characters.
+A match that contains a newline is silently truncated(!) at the
+newline.
++
+The regex can also be set via a diff driver or configuration option, see
+linkgit:gitattributes[1] or linkgit:git-config[1].  Giving it explicitly
+overrides any diff driver or configuration setting.  Diff drivers
+override configuration settings.
 
 --no-renames::
        Turn off rename detection, even when the configuration