Update description of vc-annotate's use of colors to indicate date

ranges.

1 files changed, 13 insertions, 14 deletions

diff --git a/man/files.texi b/man/files.texi
index 8ed89ac75e1..4847f0d1355 100644
--- a/man/files.texi
+++ b/man/files.texi
@@ -1672,23 +1672,22 @@ versions are not, in general, present as files on your disk.)
 @kindex C-x v g
   For some back ends, you can display the file @dfn{annotated} with
 per-line version information and using colors to enhance the visual
-appearance, with the command @kbd{M-x vc-annotate}.
-It creates a new buffer (the ``annotate buffer'') displaying the
-file's text, with each part colored to show how old it is.  Text
-colored red is new, blue means old, and intermediate colors indicate
-intermediate ages.  By default, the time scale is 360 days, so that
-everything more than one year old is shown in blue.
+appearance, with the command @kbd{M-x vc-annotate}.  It creates a new
+buffer (the ``annotate buffer'') displaying the file's text, with each
+part colored to show how old it is.  Text colored red is new, blue means
+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.
 
   When you give a prefix argument to this command, it uses the
 minibuffer to read two arguments: which version number to display and
-annotate (instead of the current file contents), and a stretch factor
-for the time scale.  A stretch factor of 0.1 means that the color
-range from red to blue spans the past 36 days instead of 360 days.  A
-stretch factor greater than 1 means the color range spans more than a
-year.
-
-  From the annotate buffer, you can use the following keys to browse the
-annotations of past revisions, view diffs, or view log entries:
+annotate (instead of the current file contents), and the time span in
+days the color range should cover.  
+
+  From the annotate buffer, these and other color scaling options are
+available from the @samp{VC-Annotate} menu.  In this buffer, you can
+also use the following keys to browse the annotations of past revisions,
+view diffs, or view log entries:
 
 @table @kbd
 @item P