From: Eli Zaretskii <eliz@gnu.org>
Date: Sat, 26 Dec 2015 16:04:03 +0000 (+0200)
Subject: Document 'vc-annotate-background-mode'
X-Git-Tag: emacs-25.0.90~368
X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=42ae568b3d187a42ead03d880efda076615e0d3a;p=emacs.git

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 2d11b201d32..801d147845b 100644
--- 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 8a926c2a731..ee56d23d174 100644
--- 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.