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: Re: save-buffers documentation Date: Thu, 17 Mar 2005 11:52:38 -0500 Message-ID: NNTP-Posting-Host: main.gmane.org X-Trace: sea.gmane.org 1111080036 11488 80.91.229.2 (17 Mar 2005 17:20:36 GMT) X-Complaints-To: usenet@sea.gmane.org NNTP-Posting-Date: Thu, 17 Mar 2005 17:20:36 +0000 (UTC) Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Thu Mar 17 18:20:35 2005 Original-Received: from lists.gnu.org ([199.232.76.165]) by ciao.gmane.org with esmtp (Exim 4.43) id 1DByW7-0006tD-Ls for geb-bug-gnu-emacs@m.gmane.org; Thu, 17 Mar 2005 18:10:40 +0100 Original-Received: from localhost ([127.0.0.1] helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1DBymR-00043K-L4 for geb-bug-gnu-emacs@m.gmane.org; Thu, 17 Mar 2005 12:27:31 -0500 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1DByl2-0003Xj-2L for bug-gnu-emacs@gnu.org; Thu, 17 Mar 2005 12:26:04 -0500 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1DByko-0003W8-IO for bug-gnu-emacs@gnu.org; Thu, 17 Mar 2005 12:25:51 -0500 Original-Received: from [199.232.76.173] (helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1DBykH-0003AG-GE for bug-gnu-emacs@gnu.org; Thu, 17 Mar 2005 12:25:18 -0500 Original-Received: from [132.198.104.184] (helo=webteam-dvd) by monty-python.gnu.org with esmtp (Exim 4.34) id 1DByHT-0007wk-5M for bug-gnu-emacs@gnu.org; Thu, 17 Mar 2005 11:55:31 -0500 Original-Received: from ashawley by webteam-dvd with local (Exim 3.36 #1 (Debian)) id 1DByEg-0001JV-00 for ; Thu, 17 Mar 2005 11:52:38 -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:10946 X-Report-Spam: http://spam.gmane.org/gmane.emacs.bugs:10946 Here's another revision of the patch that uses instead "Prefixed with", for consistency with other GNU Emacs doc-strings. enjoy. /a ===File ~/gnu/files.el-save_buffer_doc_string.diff========== --- files.el.~1.745.~ 2005-02-09 10:50:42.000000000 -0500 +++ files.el 2005-03-17 11:28:05.000000000 -0500 @@ -3102,18 +3102,20 @@ 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 +Prefixed with one \\[universal-argument], marks this version to become a backup when the next save is done. -With 2 \\[universal-argument]'s, +Prefixed with two \\[universal-argument]'s, unconditionally makes the previous version into a backup file. -With 3 \\[universal-argument]'s, marks this version +Prefixed 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. -With argument of 0, never make the previous version into a backup file. +With prefix argument of 0, never make the previous version into a + backup file. If a file's name is FOO, the names of its numbered backup versions are FOO.~i~ for various integers i. A non-numbered backup file is called FOO~. ============================================================