Commit 42ae568b authored by Eli Zaretskii's avatar Eli Zaretskii

Document 'vc-annotate-background-mode'

* doc/emacs/maintaining.texi (Old Revisions): Document
'vc-annotate-background-mode'.
parent ca13f61d
...@@ -832,15 +832,19 @@ corresponding to @var{revision}, saves it to ...@@ -832,15 +832,19 @@ corresponding to @var{revision}, saves it to
window. window.
@findex vc-annotate @findex vc-annotate
@vindex vc-annotate-background-mode
@kindex C-x v g @kindex C-x v g
Many version control systems allow you to view files @dfn{annotated} Many version control systems allow you to view files @dfn{annotated}
with per-line revision information, by typing @kbd{C-x v g} with per-line revision information, by typing @kbd{C-x v g}
(@code{vc-annotate}). This creates a new ``annotate'' buffer (@code{vc-annotate}). This creates a new ``annotate'' buffer
displaying the file's text, with each line colored to show displaying the file's text, with each line colored to show how old it
how old it is. Red text is new, blue is old, and intermediate colors is. Red text is new, blue is old, and intermediate colors indicate
indicate intermediate ages. By default, the color is scaled over the intermediate ages. By default, the color is scaled over the full
full range of ages, such that the oldest changes are blue, and the range of ages, such that the oldest changes are blue, and the newest
newest changes are red. 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 When you give a prefix argument to this command, Emacs reads two
arguments using the minibuffer: the revision to display and annotate arguments using the minibuffer: the revision to display and annotate
......
...@@ -826,6 +826,7 @@ This command is useful when you perform version control commands ...@@ -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 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. back-end for the buffer's file, or remove it from version control.
+++
*** New option `vc-annotate-background-mode' controls whether *** New option `vc-annotate-background-mode' controls whether
the color range from `vc-annotate-color-map' is applied to the the color range from `vc-annotate-color-map' is applied to the
background or to the foreground. background or to the foreground.
......
Markdown is supported
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment