doc: explain the use of color.pager

The current documentation for color.pager is technically correct, but
slightly misleading and doesn't really clarify the purpose of the
variable. As explained in the original thread which added it:

  https://lore.kernel.org/git/E1G6zPH-00062L-Je@moooo.ath.cx/

the point is to deal with pagers that don't understand colors. And hence it
being set to "true" is necessary for colorizing output to the pager, but
not sufficient by itself (you must also have enabled one of the other
color options, though note that these are set to "auto" by default these
days).

Signed-off-by: Jeff King <peff@peff.net>
Signed-off-by: Junio C Hamano <gitster@pobox.com>

diff --git a/Documentation/config/color.txt b/Documentation/config/color.txt
index d5daacb13a2c77160accac4e46b1381cf8214f24..e05d520a867490ce6b5388e2c48d1ce53de4e07e 100644 (file)
--- a/Documentation/config/color.txt
+++ b/Documentation/config/color.txt
@@ -127,8 +127,9 @@ color.interactive.<slot>::
        interactive commands.
 
 color.pager::
-       A boolean to enable/disable colored output when the pager is in
-       use (default is true).
+       A boolean to specify whether `auto` color modes should colorize
+       output going to the pager. Defaults to true; set this to false
+       if your pager does not understand ANSI color codes.
 
 color.push::
        A boolean to enable/disable color in push errors. May be set to