From: Richard M. Stallman <rms@gnu.org>
Date: Thu, 6 Sep 2001 19:39:40 +0000 (+0000)
Subject: Clarify description of vc-annotate.
X-Git-Tag: emacs-pretest-21.0.106~217
X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=67696322252e5ca5197c948d5559f32a480a64c6;p=emacs.git

Clarify description of vc-annotate.
---

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