Document 'vc-annotate-background-mode'

* doc/emacs/maintaining.texi (Old Revisions): Document
'vc-annotate-background-mode'.

diff --git a/doc/emacs/maintaining.texi b/doc/emacs/maintaining.texi
index 2d11b201d32d001b43659fc7c1c4e3e7eb112bbe..801d147845b7e84761d0789e53bd589212acefd8 100644 (file)
--- a/doc/emacs/maintaining.texi
+++ b/doc/emacs/maintaining.texi
@@ -832,15 +832,19 @@ corresponding to @var{revision}, saves it to
 window.
 
 @findex vc-annotate
+@vindex vc-annotate-background-mode
 @kindex C-x v g
   Many version control systems allow you to view files @dfn{annotated}
 with per-line revision information, by typing @kbd{C-x v g}
 (@code{vc-annotate}).  This creates a new ``annotate'' buffer
-displaying the file's text, with each line colored to show
-how old it is.  Red text is new, blue is old, and intermediate colors
-indicate intermediate ages.  By default, the color is scaled over the
-full range of ages, such that the oldest changes are blue, and the
-newest changes are red.
+displaying the file's text, with each line colored to show how old it
+is.  Red text is new, blue is old, and intermediate colors indicate
+intermediate ages.  By default, the color is scaled over the full
+range of ages, such that the oldest changes are blue, and the newest
+changes are red.  If the variable @code{vc-annotate-background-mode}
+is non-@code{nil}, the colors expressing the age of each line are
+applied to the background color, leaving the foreground at its default
+color.
 
   When you give a prefix argument to this command, Emacs reads two
 arguments using the minibuffer: the revision to display and annotate

diff --git a/etc/NEWS b/etc/NEWS
index 8a926c2a731e9c058596e83eb76626afb8e15d3d..ee56d23d1744f0f824a2869376b5ed36b6b9142f 100644 (file)
--- a/etc/NEWS
+++ b/etc/NEWS
@@ -826,6 +826,7 @@ This command is useful when you perform version control commands
 outside Emacs (e.g., from the shell prompt), or if you switch the VC
 back-end for the buffer's file, or remove it from version control.
 
++++
 *** New option `vc-annotate-background-mode' controls whether
 the color range from `vc-annotate-color-map' is applied to the
 background or to the foreground.