Clarify description of vc-annotate.

1 files changed, 13 insertions, 6 deletions

diff --git a/man/files.texi b/man/files.texi
index 51632006db2..078cc5411a6 100644
--- a/man/files.texi
+++ b/man/files.texi
@@ -1469,12 +1469,19 @@ them; they exist only in the records of the master file.
 @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