From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: "Drew Adams" Newsgroups: gmane.emacs.bugs Subject: bug#10346: 24.0.92; doc string of `save-buffer' Date: Wed, 21 Dec 2011 14:15:05 -0800 Message-ID: <34F77D4702114FF094072B135F951820@us.oracle.com> NNTP-Posting-Host: lo.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit X-Trace: dough.gmane.org 1324505766 19907 80.91.229.12 (21 Dec 2011 22:16:06 GMT) X-Complaints-To: usenet@dough.gmane.org NNTP-Posting-Date: Wed, 21 Dec 2011 22:16:06 +0000 (UTC) To: 10346@debbugs.gnu.org Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Wed Dec 21 23:16:02 2011 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([140.186.70.17]) by lo.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1RdUS9-0008EX-5w for geb-bug-gnu-emacs@m.gmane.org; Wed, 21 Dec 2011 23:16:01 +0100 Original-Received: from localhost ([::1]:57123 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1RdUS8-0007t7-G4 for geb-bug-gnu-emacs@m.gmane.org; Wed, 21 Dec 2011 17:16:00 -0500 Original-Received: from eggs.gnu.org ([140.186.70.92]:53627) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1RdUS5-0007sc-Fz for bug-gnu-emacs@gnu.org; Wed, 21 Dec 2011 17:15:58 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1RdUS4-0001NY-4W for bug-gnu-emacs@gnu.org; Wed, 21 Dec 2011 17:15:57 -0500 Original-Received: from debbugs.gnu.org ([140.186.70.43]:47589) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1RdUS3-0001NU-VT for bug-gnu-emacs@gnu.org; Wed, 21 Dec 2011 17:15:56 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.69) (envelope-from ) id 1RdUU5-0003Qx-UV for bug-gnu-emacs@gnu.org; Wed, 21 Dec 2011 17:18:01 -0500 X-Loop: help-debbugs@gnu.org Resent-From: "Drew Adams" Original-Sender: debbugs-submit-bounces@debbugs.gnu.org Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Wed, 21 Dec 2011 22:18:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 10346 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: X-Debbugs-Original-To: Original-Received: via spool by submit@debbugs.gnu.org id=B.132450584113147 (code B ref -1); Wed, 21 Dec 2011 22:18:01 +0000 Original-Received: (at submit) by debbugs.gnu.org; 21 Dec 2011 22:17:21 +0000 Original-Received: from localhost ([127.0.0.1] helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1RdUTQ-0003Pz-Kh for submit@debbugs.gnu.org; Wed, 21 Dec 2011 17:17:21 -0500 Original-Received: from eggs.gnu.org ([140.186.70.92]) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1RdUTO-0003Pt-Pp for submit@debbugs.gnu.org; Wed, 21 Dec 2011 17:17:19 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1RdURL-0001Kk-K0 for submit@debbugs.gnu.org; Wed, 21 Dec 2011 17:15:12 -0500 Original-Received: from lists.gnu.org ([140.186.70.17]:60484) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1RdURL-0001Kg-IX for submit@debbugs.gnu.org; Wed, 21 Dec 2011 17:15:11 -0500 Original-Received: from eggs.gnu.org ([140.186.70.92]:53522) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1RdURK-0007nn-HJ for bug-gnu-emacs@gnu.org; Wed, 21 Dec 2011 17:15:11 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1RdURJ-0001K0-Dw for bug-gnu-emacs@gnu.org; Wed, 21 Dec 2011 17:15:10 -0500 Original-Received: from rcsinet15.oracle.com ([148.87.113.117]:37785) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1RdURJ-0001Jp-8k for bug-gnu-emacs@gnu.org; Wed, 21 Dec 2011 17:15:09 -0500 Original-Received: from ucsinet21.oracle.com (ucsinet21.oracle.com [156.151.31.93]) by rcsinet15.oracle.com (Switch-3.4.4/Switch-3.4.4) with ESMTP id pBLMF7a5015818 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK) for ; Wed, 21 Dec 2011 22:15:08 GMT Original-Received: from acsmt357.oracle.com (acsmt357.oracle.com [141.146.40.157]) by ucsinet21.oracle.com (8.14.4+Sun/8.14.4) with ESMTP id pBLMF6mD023100 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NO) for ; Wed, 21 Dec 2011 22:15:07 GMT Original-Received: from abhmt111.oracle.com (abhmt111.oracle.com [141.146.116.63]) by acsmt357.oracle.com (8.12.11.20060308/8.12.11) with ESMTP id pBLMF6BA025035 for ; Wed, 21 Dec 2011 16:15:06 -0600 Original-Received: from dradamslap1 (/130.35.178.194) by default (Oracle Beehive Gateway v4.0) with ESMTP ; Wed, 21 Dec 2011 14:15:06 -0800 X-Mailer: Microsoft Office Outlook 11 Thread-Index: AczALf3ZPjvOfATySEC6nN09qNcF+g== X-MimeOLE: Produced By Microsoft MimeOLE V6.00.2900.6157 X-Source-IP: ucsinet21.oracle.com [156.151.31.93] X-CT-RefId: str=0001.0A090206.4EF25A6C.0093,ss=1,re=0.000,fgs=0 X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 1) X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 3) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.11 Precedence: list Resent-Date: Wed, 21 Dec 2011 17:18:01 -0500 X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 2) X-Received-From: 140.186.70.43 X-BeenThere: bug-gnu-emacs@gnu.org List-Id: "Bug reports for GNU Emacs, the Swiss army knife of text editors" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Original-Sender: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.bugs:55110 Archived-At: Please describe the optional argument ARGS (which should be called ARG, BTW, since it is not &rest and it is not a cons in general). The doc string talks about the prefix arg, but no connection is made to ARGS for use in Lisp. Furthermore, "With a numeric argument of 0" is incorrect and misleads. For an interactive user, this should be stated in terms of the numeric value of the prefix argument, not just "a numeric argument". In general, reread the doc string, and I'm sure you will see that it could be improved wrt describing the use of a prefix arg and the use of the argument from Lisp. In GNU Emacs 24.0.92.1 (i386-mingw-nt5.1.2600) of 2011-12-06 on MARVIN Windowing system distributor `Microsoft Corp.', version 5.1.2600 configured using `configure --with-gcc (4.6) --no-opt --cflags -ID:/devel/emacs/libs/libXpm-3.5.8/include -ID:/devel/emacs/libs/libXpm-3.5.8/src -ID:/devel/emacs/libs/libpng-dev_1.4.3-1/include -ID:/devel/emacs/libs/zlib-dev_1.2.5-2/include -ID:/devel/emacs/libs/giflib-4.1.4-1/include -ID:/devel/emacs/libs/jpeg-6b-4/include -ID:/devel/emacs/libs/tiff-3.8.2-1/include -ID:/devel/emacs/libs/gnutls-2.10.1/include --ldflags -LD:/devel/emacs/libs/gnutls-2.10.1/lib'