From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Lars Ingebrigtsen Newsgroups: gmane.emacs.bugs Subject: bug#10346: 24.0.92; doc string of `save-buffer' Date: Sat, 08 Feb 2014 21:35:45 -0800 Message-ID: <87iosoalvy.fsf@building.gnus.org> References: <34F77D4702114FF094072B135F951820@us.oracle.com> NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain X-Trace: ger.gmane.org 1391924291 29637 80.91.229.3 (9 Feb 2014 05:38:11 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Sun, 9 Feb 2014 05:38:11 +0000 (UTC) Cc: 10346@debbugs.gnu.org To: "Drew Adams" Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Sun Feb 09 06:38:19 2014 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([208.118.235.17]) by plane.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1WCN5s-0007Eo-OD for geb-bug-gnu-emacs@m.gmane.org; Sun, 09 Feb 2014 06:38:16 +0100 Original-Received: from localhost ([::1]:49343 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1WCN5s-0001d8-CW for geb-bug-gnu-emacs@m.gmane.org; Sun, 09 Feb 2014 00:38:16 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:43799) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1WCN5k-0001cu-BQ for bug-gnu-emacs@gnu.org; Sun, 09 Feb 2014 00:38:13 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1WCN5f-0006BT-DD for bug-gnu-emacs@gnu.org; Sun, 09 Feb 2014 00:38:08 -0500 Original-Received: from debbugs.gnu.org ([140.186.70.43]:44977) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1WCN5f-0006BP-9v for bug-gnu-emacs@gnu.org; Sun, 09 Feb 2014 00:38:03 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.80) (envelope-from ) id 1WCN5e-0000lM-Um for bug-gnu-emacs@gnu.org; Sun, 09 Feb 2014 00:38:03 -0500 X-Loop: help-debbugs@gnu.org Resent-From: Lars Ingebrigtsen Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sun, 09 Feb 2014 05:38:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 10346 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: Original-Received: via spool by 10346-submit@debbugs.gnu.org id=B10346.13919242352864 (code B ref 10346); Sun, 09 Feb 2014 05:38:02 +0000 Original-Received: (at 10346) by debbugs.gnu.org; 9 Feb 2014 05:37:15 +0000 Original-Received: from localhost ([127.0.0.1]:58996 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1WCN4t-0000k8-3z for submit@debbugs.gnu.org; Sun, 09 Feb 2014 00:37:15 -0500 Original-Received: from hermes.netfonds.no ([80.91.224.195]:48331) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1WCN4q-0000jx-EZ for 10346@debbugs.gnu.org; Sun, 09 Feb 2014 00:37:13 -0500 Original-Received: from [204.14.154.233] (helo=building.gnus.org) by hermes.netfonds.no with esmtpsa (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.72) (envelope-from ) id 1WCN4b-0006P8-BW; Sun, 09 Feb 2014 06:36:57 +0100 In-Reply-To: <34F77D4702114FF094072B135F951820@us.oracle.com> (Drew Adams's message of "Wed, 21 Dec 2011 14:15:05 -0800") User-Agent: Gnus/5.13001 (Ma Gnus v0.10) Emacs/24.3.50 (gnu/linux) X-MailScanner-ID: 1WCN4b-0006P8-BW MailScanner-NULL-Check: 1392529018.42228@/EgEuD+ePyLB3RgagXhJRg X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.15 Precedence: list X-detected-operating-system: by eggs.gnu.org: GNU/Linux 3.x 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:85061 Archived-At: "Drew Adams" writes: > 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). Fixed on trunk. > The doc string talks about the prefix arg, but no connection is made to > ARGS for use in Lisp. Yes. But the values for ARG are so... non-Lispey, I have a feeling that it's been left off by choice. The values are basically 0, 4, 16 and 64, which are ... kinda opaque when calling a function like that. I don't know. Should these values be documented or not? > 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". Fixed on trunk. -- (domestic pets only, the antidote for overdose, milk.) bloggy blog http://lars.ingebrigtsen.no/