From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Luc Teirlinck Newsgroups: gmane.emacs.devel Subject: man/files.texi Date: Sat, 26 Mar 2005 21:51:59 -0600 (CST) Message-ID: <200503270351.j2R3pxo18619@raven.dms.auburn.edu> NNTP-Posting-Host: main.gmane.org X-Trace: sea.gmane.org 1111897083 7375 80.91.229.2 (27 Mar 2005 04:18:03 GMT) X-Complaints-To: usenet@sea.gmane.org NNTP-Posting-Date: Sun, 27 Mar 2005 04:18:03 +0000 (UTC) Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Sun Mar 27 06:18:01 2005 Original-Received: from lists.gnu.org ([199.232.76.165]) by ciao.gmane.org with esmtp (Exim 4.43) id 1DFPDq-0001oF-P9 for ged-emacs-devel@m.gmane.org; Sun, 27 Mar 2005 06:17:59 +0200 Original-Received: from localhost ([127.0.0.1] helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1DFPTf-00049e-Hp for ged-emacs-devel@m.gmane.org; Sat, 26 Mar 2005 23:34:19 -0500 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1DFPLJ-0001T7-OZ for emacs-devel@gnu.org; Sat, 26 Mar 2005 23:25:42 -0500 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1DFPL4-0001Nd-37 for emacs-devel@gnu.org; Sat, 26 Mar 2005 23:25:33 -0500 Original-Received: from [199.232.76.173] (helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1DFPL1-0001J1-TJ for emacs-devel@gnu.org; Sat, 26 Mar 2005 23:25:23 -0500 Original-Received: from [131.204.53.104] (helo=manatee.dms.auburn.edu) by monty-python.gnu.org with esmtp (Exim 4.34) id 1DFOpW-0003PR-1C for emacs-devel@gnu.org; Sat, 26 Mar 2005 22:52:50 -0500 Original-Received: from raven.dms.auburn.edu (raven.dms.auburn.edu [131.204.53.29]) by manatee.dms.auburn.edu (8.12.10/8.12.10) with ESMTP id j2R3qn9N004949 for ; Sat, 26 Mar 2005 21:52:49 -0600 (CST) Original-Received: (from teirllm@localhost) by raven.dms.auburn.edu (8.11.7p1+Sun/8.11.7) id j2R3pxo18619; Sat, 26 Mar 2005 21:51:59 -0600 (CST) X-Authentication-Warning: raven.dms.auburn.edu: teirllm set sender to teirllm@dms.auburn.edu using -f Original-To: emacs-devel@gnu.org 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:35223 X-Report-Spam: http://spam.gmane.org/gmane.emacs.devel:35223 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 ============================================================