changeset 39163:8c66ad9acae0

Clarify description of vc-annotate.

--- a/man/files.texi	Thu Sep 06 19:37:39 2001 +0000
+++ b/man/files.texi	Thu Sep 06 19:39:40 2001 +0000
@@ -1469,12 +1469,19 @@
 @kindex C-x v g
   For CVS-controlled files, you can display the result of the CVS
 annotate command, using colors to enhance the visual appearance.  Use
-the command @kbd{M-x vc-annotate} to do this.  Red means 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.  Giving a prefix argument @var{n} to this
-command multiplies the time scale by @var{n}, so that all text over
-@var{n} years old is shown in blue.
+the command @kbd{M-x vc-annotate} to do this.  It creates a new buffer
+to display file's text, colored to show how old each part 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.
+
+  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.
 
 @node Secondary VC Commands
 @subsection The Secondary Commands of VC