From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Aaron Hawley Newsgroups: gmane.emacs.bugs Subject: save-buffers documentation Date: Fri, 11 Mar 2005 15:49:10 -0500 Message-ID: Reply-To: Aaron.Hawley@uvm.edu NNTP-Posting-Host: main.gmane.org X-Trace: sea.gmane.org 1110575674 3972 80.91.229.2 (11 Mar 2005 21:14:34 GMT) X-Complaints-To: usenet@sea.gmane.org NNTP-Posting-Date: Fri, 11 Mar 2005 21:14:34 +0000 (UTC) Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Fri Mar 11 22:14:34 2005 Original-Received: from lists.gnu.org ([199.232.76.165]) by ciao.gmane.org with esmtp (Exim 4.43) id 1D9rLQ-0003bE-5y for geb-bug-gnu-emacs@m.gmane.org; Fri, 11 Mar 2005 22:06:52 +0100 Original-Received: from localhost ([127.0.0.1] helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1D9raZ-00064v-Ba for geb-bug-gnu-emacs@m.gmane.org; Fri, 11 Mar 2005 16:22:31 -0500 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1D9rYp-0005S2-Tt for bug-gnu-emacs@gnu.org; Fri, 11 Mar 2005 16:20:44 -0500 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1D9rYl-0005PL-9K for bug-gnu-emacs@gnu.org; Fri, 11 Mar 2005 16:20:40 -0500 Original-Received: from [199.232.76.173] (helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1D9rYk-0005Cr-5J for bug-gnu-emacs@gnu.org; Fri, 11 Mar 2005 16:20:38 -0500 Original-Received: from [132.198.104.184] (helo=webteam-dvd) by monty-python.gnu.org with esmtp (Exim 4.34) id 1D9r6h-0007JV-MR for bug-gnu-emacs@gnu.org; Fri, 11 Mar 2005 15:51:39 -0500 Original-Received: from ashawley by webteam-dvd with local (Exim 3.36 #1 (Debian)) id 1D9r4I-0004UV-00 for ; Fri, 11 Mar 2005 15:49:10 -0500 Original-To: bug-gnu-emacs@gnu.org X-BeenThere: bug-gnu-emacs@gnu.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: "Bug reports for GNU Emacs, the Swiss army knife of text editors" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Original-Sender: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Errors-To: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org X-MailScanner-To: geb-bug-gnu-emacs@m.gmane.org Xref: news.gmane.org gmane.emacs.bugs:10913 X-Report-Spam: http://spam.gmane.org/gmane.emacs.bugs:10913 In GNU Emacs 21.3.1 (i386-pc-linux-gnu, X toolkit, Xaw3d scroll bars) of 2004-10-16 on raven, modified by Debian configured using `configure '--build=i386-linux' '--host=i386-linux' '--prefix=/usr' '--sharedstatedir=/var/lib' '--libexecdir=/usr/lib' '--localstatedir=/var/lib' '--infodir=/usr/share/info' '--mandir=/usr/share/man' '--with-pop=yes' '--with-x=yes' '--with-x-toolkit=athena' 'CFLAGS=-DDEBIAN -g -O2' 'build_alias=i386-linux' 'host_alias=i386-linux'' Important settings: value of $LC_ALL: nil value of $LC_COLLATE: nil value of $LC_CTYPE: nil value of $LC_MESSAGES: nil value of $LC_MONETARY: nil value of $LC_NUMERIC: nil value of $LC_TIME: nil value of $LANG: C locale-coding-system: nil default-enable-multibyte-characters: t Please describe exactly what actions triggered the bug and the precise symptoms of the bug: When visiting the `save-buffer' help screen, I found the first section of the function's documentation string to be confusing. Below is a patch against CVS that offers some rough suggestions. The existing documentation in its current state (in my version of Emacs) is below the patch. Thanks for GNU Emacs. /a --- files.el.~1.745.~ 2005-02-09 10:50:42.000000000 -0500 +++ files.el 2005-03-11 12:58:13.000000000 -0500 @@ -3102,14 +3102,14 @@ ancestor)))))) (defun save-buffer (&optional args) - "Save current buffer in visited file if modified. Versions described below. + "Save current buffer in visited file if modified. Variations are described below. By default, makes the previous version into a backup file if previously requested or if this is the first save. -With 1 \\[universal-argument], marks this version +Combined with one \\[universal-argument], marks this version to become a backup when the next save is done. -With 2 \\[universal-argument]'s, +Combined with two \\[universal-argument]'s, unconditionally makes the previous version into a backup file. -With 3 \\[universal-argument]'s, marks this version +Combined with three \\[universal-argument]'s, marks this version to become a backup when the next save is done, and unconditionally makes the previous version into a backup file. C-x C-s runs the command save-buffer which is an interactive compiled Lisp function in `files'. (save-buffer &optional ARGS) Save current buffer in visited file if modified. Versions described below. By default, makes the previous version into a backup file if previously requested or if this is the first save. With 1 C-u, marks this version to become a backup when the next save is done. With 2 C-u's, unconditionally makes the previous version into a backup file. With 3 C-u's, marks this version to become a backup when the next save is done, and unconditionally makes the previous version into a backup file. With argument of 0, never make the previous version into a backup file. Recent input: C-h k C-x C-s Recent messages: Type C-x 1 to remove help window. C-M-v to scroll the help. Loading emacsbug...done