From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: "Eli Zaretskii" Newsgroups: gmane.emacs.devel Subject: Re: man/files.texi Date: Sun, 27 Mar 2005 13:00:31 +0200 Message-ID: <01c532bc$Blat.v2.4$571d36e0@zahav.net.il> References: <200503270351.j2R3pxo18619@raven.dms.auburn.edu> Reply-To: Eli Zaretskii NNTP-Posting-Host: main.gmane.org Content-Type: text/plain; charset=ISO-8859-1 Content-Transfer-Encoding: 7BIT X-Trace: sea.gmane.org 1111922832 18696 80.91.229.2 (27 Mar 2005 11:27:12 GMT) X-Complaints-To: usenet@sea.gmane.org NNTP-Posting-Date: Sun, 27 Mar 2005 11:27:12 +0000 (UTC) Cc: emacs-devel@gnu.org Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Sun Mar 27 13:27:10 2005 Original-Received: from lists.gnu.org ([199.232.76.165]) by ciao.gmane.org with esmtp (Exim 4.43) id 1DFVv5-0004FW-N2 for ged-emacs-devel@m.gmane.org; Sun, 27 Mar 2005 13:27:05 +0200 Original-Received: from localhost ([127.0.0.1] helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1DFWAx-00046p-TY for ged-emacs-devel@m.gmane.org; Sun, 27 Mar 2005 06:43:28 -0500 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1DFW1P-0002LH-6T for emacs-devel@gnu.org; Sun, 27 Mar 2005 06:33:36 -0500 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1DFW1I-0002KK-6b for emacs-devel@gnu.org; Sun, 27 Mar 2005 06:33:28 -0500 Original-Received: from [199.232.76.173] (helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1DFVt7-0001ut-AE for emacs-devel@gnu.org; Sun, 27 Mar 2005 06:25:04 -0500 Original-Received: from [192.114.186.66] (helo=romy.inter.net.il) by monty-python.gnu.org with esmtp (Exim 4.34) id 1DFVYh-00074S-Ev for emacs-devel@gnu.org; Sun, 27 Mar 2005 06:03:55 -0500 Original-Received: from zaretski (IGLD-83-130-253-83.inter.net.il [83.130.253.83]) by romy.inter.net.il (MOS 3.5.6-GR) with ESMTP id AVO12792 (AUTH halo1); Sun, 27 Mar 2005 13:03:45 +0200 (IST) Original-To: Luc Teirlinck X-Mailer: emacs 22.0.50 (via feedmail 8 I) and Blat ver 2.4 In-reply-to: <200503270351.j2R3pxo18619@raven.dms.auburn.edu> (message from Luc Teirlinck on Sat, 26 Mar 2005 21:51:59 -0600 (CST)) X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: "Emacs development discussions." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Original-Sender: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.devel:35230 X-Report-Spam: http://spam.gmane.org/gmane.emacs.devel:35230 > Date: Sat, 26 Mar 2005 21:51:59 -0600 (CST) > From: 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. 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.