man/files.texi

[Luc Teirlinck]

The recent addition of auto-revert-check-vc-info to man/files.texi is
somewhat confusing.  It seems to suggest that the normal state of any
buffer is to have version control info in the mode line.  Just
mentioning VC without reference at that stage is confusing to a reader
reading the manual back to front, because the concept of VC has not
yet been introduced at that stage.  What about the following small
change?  I can install if desired.

===File ~/man-files.texi-diff===============================
*** files.texi  26 Mar 2005 09:57:37 -0600      1.101
--- files.texi  26 Mar 2005 20:54:06 -0600      
***************
*** 941,953 ****
  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.
  
  @node Auto Save
  @section Auto-Saving: Protection Against Disasters
--- 941,954 ----
  modes do not check or revert remote files.
  
  @vindex auto-revert-check-vc-info
!   Whenever Auto Revert mode reverts a buffer that is under version
! control (@pxref{Version Control}), 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.
  
  @node Auto Save
  @section Auto-Saving: Protection Against Disasters
============================================================