From: Luc Teirlinck <teirllm@auburn.edu>
Date: Fri, 1 Apr 2005 02:06:49 +0000 (+0000)
Subject: (Reverting): Move `auto-revert-check-vc-info' to `VC Mode Line' and
X-Git-Tag: ttn-vms-21-2-B4~1306
X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=ea98eb11f5549737255e90512969014777723f04;p=emacs.git

(Reverting): Move `auto-revert-check-vc-info' to `VC Mode Line' and
put in an xref to that node.
(VC Mode Line): Move `auto-revert-check-vc-info' here and clarify its
description.
---

diff --git a/man/files.texi b/man/files.texi
index 7ed2baa0b93..a03bb2a64ea 100644
--- a/man/files.texi
+++ b/man/files.texi
@@ -940,14 +940,8 @@ Auto-Revert Tail mode, @kbd{M-x auto-revert-tail-mode}.
 for a changed file.  Since checking a remote file is too slow, these
 modes do not check or revert remote files.
 
-@vindex auto-revert-check-vc-info
-  Whenever Auto Revert mode reverts the buffer, it updates the version
-control information, such as the version control number displayed in
-the mode line.  However, this information may not be properly updated
-if the version control state changes outside of Emacs---for example,
-if a new version is checked in from outside the current Emacs session.
-If you set @code{auto-revert-check-vc-info} to @code{t}, Auto Revert
-mode will update the version control status information periodically.
+@xref{VC Mode Line}, for Auto Revert peculiarities in buffers that
+visit files under version control.
 
 @node Auto Save
 @section Auto-Saving: Protection Against Disasters
@@ -1375,6 +1369,18 @@ locking is not in use).  @samp{:} indicates that the file is locked, or
 that it is modified.  If the file is locked by some other user (for
 instance, @samp{jim}), that is displayed as @samp{RCS:jim:1.3}.
 
+@vindex auto-revert-check-vc-info
+  When Auto Revert mode (@pxref{Reverting}) reverts a buffer that is
+under version control, it updates the version control information in
+the mode line.  However, Auto Revert mode may not properly update this
+information if the version control status changes without changes to
+the work file, from outside the current Emacs session.  If you set
+@code{auto-revert-check-vc-info} to @code{t}, Auto Revert mode updates
+the version control status information every
+@code{auto-revert-interval} seconds, even if the work file itself is
+unchanged.  The resulting CPU usage depends on the version control
+system, but is usually not excessive.
+
 @node Basic VC Editing
 @subsection Basic Editing under Version Control