color-words: expand docs with precise semantics
[gitweb.git] / Documentation / diff-options.txt
index 43793d75005a7af875a055d377a8ab6a13510682..8689a92d8d10cd98ba7d0d5381e7cc855971413e 100644 (file)
@@ -91,8 +91,17 @@ 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.
 
 --no-renames::
        Turn off rename detection, even when the configuration