]> code.delx.au - gnu-emacs/commitdiff
Clarify description of vc-annotate.
authorRichard M. Stallman <rms@gnu.org>
Thu, 6 Sep 2001 19:39:40 +0000 (19:39 +0000)
committerRichard M. Stallman <rms@gnu.org>
Thu, 6 Sep 2001 19:39:40 +0000 (19:39 +0000)
man/files.texi

index 51632006db2a3df15dc405f5bebe8b027b2e7a0e..078cc5411a6a16eb6dcbf3fe59d407b3207625fe 100644 (file)
@@ -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