diff --git a/doc/emacs/maintaining.texi b/doc/emacs/maintaining.texi index 2d11b201d32d001b43659fc7c1c4e3e7eb112bbe..801d147845b7e84761d0789e53bd589212acefd8 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 8a926c2a731e9c058596e83eb76626afb8e15d3d..ee56d23d1744f0f824a2869376b5ed36b6b9142f 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.