emacs-devel
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: man/files.texi


From: Eli Zaretskii
Subject: Re: man/files.texi
Date: Sun, 27 Mar 2005 13:00:31 +0200

> Date: Sat, 26 Mar 2005 21:51:59 -0600 (CST)
> From: Luc Teirlinck <address@hidden>
> 
> 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.

Indeed.

> 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      

How about moving the entire documentation of auto-revert-check-vc-info
to one of the sections that document VC?  The section about reverting
could then say something like

  xref{..., auto-revert-check-vc-info}, for Auto Revert peculiarities
  in buffers that visit files under version control.




reply via email to

[Prev in Thread] Current Thread [Next in Thread]