From unknown Fri Sep 19 21:29:42 2025 X-Loop: help-debbugs@gnu.org Subject: bug#10346: 24.0.92; doc string of `save-buffer' 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: To: 10346@debbugs.gnu.org X-Debbugs-Original-To: Received: via spool by submit@debbugs.gnu.org id=B.132450584113147 (code B ref -1); Wed, 21 Dec 2011 22:18:01 +0000 Received: (at submit) by debbugs.gnu.org; 21 Dec 2011 22:17:21 +0000 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 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 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 X-Spam-Checker-Version: SpamAssassin 3.3.2 (2011-06-06) on eggs.gnu.org X-Spam-Level: X-Spam-Status: No, score=-6.8 required=5.0 tests=BAYES_00,RCVD_IN_DNSWL_MED, RP_MATCHES_RCVD,UNPARSEABLE_RELAY autolearn=unavailable version=3.3.2 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 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 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 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 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 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 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 Received: from dradamslap1 (/130.35.178.194) by default (Oracle Beehive Gateway v4.0) with ESMTP ; Wed, 21 Dec 2011 14:15:06 -0800 From: "Drew Adams" Date: Wed, 21 Dec 2011 14:15:05 -0800 Message-ID: <34F77D4702114FF094072B135F951820@us.oracle.com> MIME-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit 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-Received-From: 140.186.70.17 X-Spam-Score: -6.2 (------) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.11 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: debbugs-submit-bounces@debbugs.gnu.org Errors-To: debbugs-submit-bounces@debbugs.gnu.org X-Spam-Score: -6.2 (------) 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' From unknown Fri Sep 19 21:29:42 2025 X-Loop: help-debbugs@gnu.org Subject: bug#10346: 24.0.92; doc string of `save-buffer' Resent-From: "Drew Adams" Original-Sender: debbugs-submit-bounces@debbugs.gnu.org Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Mon, 17 Sep 2012 00:22: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: To: <10346@debbugs.gnu.org> Received: via spool by 10346-submit@debbugs.gnu.org id=B10346.134784128525840 (code B ref 10346); Mon, 17 Sep 2012 00:22:02 +0000 Received: (at 10346) by debbugs.gnu.org; 17 Sep 2012 00:21:25 +0000 Received: from localhost ([127.0.0.1]:37923 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1TDP5Z-0006ij-2O for submit@debbugs.gnu.org; Sun, 16 Sep 2012 20:21:25 -0400 Received: from rcsinet15.oracle.com ([148.87.113.117]:49722) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1TDP5X-0006ia-DH for 10346@debbugs.gnu.org; Sun, 16 Sep 2012 20:21:23 -0400 Received: from ucsinet22.oracle.com (ucsinet22.oracle.com [156.151.31.94]) by rcsinet15.oracle.com (Sentrion-MTA-4.2.2/Sentrion-MTA-4.2.2) with ESMTP id q8H0KA2f014991 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK) for <10346@debbugs.gnu.org>; Mon, 17 Sep 2012 00:20:11 GMT Received: from acsmt358.oracle.com (acsmt358.oracle.com [141.146.40.158]) by ucsinet22.oracle.com (8.14.4+Sun/8.14.4) with ESMTP id q8H0KA9Y019913 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NO) for <10346@debbugs.gnu.org>; Mon, 17 Sep 2012 00:20:10 GMT Received: from abhmt104.oracle.com (abhmt104.oracle.com [141.146.116.56]) by acsmt358.oracle.com (8.12.11.20060308/8.12.11) with ESMTP id q8H0K9lC026936 for <10346@debbugs.gnu.org>; Sun, 16 Sep 2012 19:20:10 -0500 Received: from dradamslap1 (/10.159.170.142) by default (Oracle Beehive Gateway v4.0) with ESMTP ; Sun, 16 Sep 2012 17:20:09 -0700 From: "Drew Adams" References: <34F77D4702114FF094072B135F951820@us.oracle.com> Date: Sun, 16 Sep 2012 17:19:59 -0700 Message-ID: MIME-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit X-Mailer: Microsoft Office Outlook 11 In-Reply-To: <34F77D4702114FF094072B135F951820@us.oracle.com> Thread-Index: AczALf3ZPjvOfATySEC6nN09qNcF+jUPCb0g X-MimeOLE: Produced By Microsoft MimeOLE V6.00.2900.6157 X-Source-IP: ucsinet22.oracle.com [156.151.31.94] X-Spam-Score: -7.4 (-------) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.13 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: debbugs-submit-bounces@debbugs.gnu.org Errors-To: debbugs-submit-bounces@debbugs.gnu.org X-Spam-Score: -7.4 (-------) ping From unknown Fri Sep 19 21:29:42 2025 X-Loop: help-debbugs@gnu.org Subject: bug#10346: 24.0.92; doc string of `save-buffer' 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: To: "Drew Adams" Cc: 10346@debbugs.gnu.org Received: via spool by 10346-submit@debbugs.gnu.org id=B10346.13919242352864 (code B ref 10346); Sun, 09 Feb 2014 05:38:02 +0000 Received: (at 10346) by debbugs.gnu.org; 9 Feb 2014 05:37:15 +0000 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 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 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 From: Lars Ingebrigtsen References: <34F77D4702114FF094072B135F951820@us.oracle.com> Date: Sat, 08 Feb 2014 21:35:45 -0800 In-Reply-To: <34F77D4702114FF094072B135F951820@us.oracle.com> (Drew Adams's message of "Wed, 21 Dec 2011 14:15:05 -0800") Message-ID: <87iosoalvy.fsf@building.gnus.org> User-Agent: Gnus/5.13001 (Ma Gnus v0.10) Emacs/24.3.50 (gnu/linux) MIME-Version: 1.0 Content-Type: text/plain X-MailScanner-ID: 1WCN4b-0006P8-BW X-Netfonds-MailScanner: Found to be clean X-Netfonds-MailScanner-From: larsi@gnus.org MailScanner-NULL-Check: 1392529018.42228@/EgEuD+ePyLB3RgagXhJRg X-Spam-Status: No X-Spam-Score: 0.0 (/) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.15 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: 0.0 (/) "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/ From unknown Fri Sep 19 21:29:42 2025 X-Loop: help-debbugs@gnu.org Subject: bug#10346: 24.0.92; doc string of `save-buffer' Resent-From: Drew Adams Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Tue, 11 Feb 2014 15:03: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: To: Lars Ingebrigtsen Cc: 10346@debbugs.gnu.org Received: via spool by 10346-submit@debbugs.gnu.org id=B10346.139213095215306 (code B ref 10346); Tue, 11 Feb 2014 15:03:02 +0000 Received: (at 10346) by debbugs.gnu.org; 11 Feb 2014 15:02:32 +0000 Received: from localhost ([127.0.0.1]:47565 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1WDEr1-0003yn-Vd for submit@debbugs.gnu.org; Tue, 11 Feb 2014 10:02:32 -0500 Received: from aserp1040.oracle.com ([141.146.126.69]:32945) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1WDEqz-0003yP-58 for 10346@debbugs.gnu.org; Tue, 11 Feb 2014 10:02:29 -0500 Received: from acsinet21.oracle.com (acsinet21.oracle.com [141.146.126.237]) by aserp1040.oracle.com (Sentrion-MTA-4.3.2/Sentrion-MTA-4.3.2) with ESMTP id s1BF2Mt6006915 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK); Tue, 11 Feb 2014 15:02:22 GMT Received: from aserz7021.oracle.com (aserz7021.oracle.com [141.146.126.230]) by acsinet21.oracle.com (8.14.4+Sun/8.14.4) with ESMTP id s1BF2Lbt025971 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NO); Tue, 11 Feb 2014 15:02:21 GMT Received: from abhmp0005.oracle.com (abhmp0005.oracle.com [141.146.116.11]) by aserz7021.oracle.com (8.14.4+Sun/8.14.4) with ESMTP id s1BF2L8M025960; Tue, 11 Feb 2014 15:02:21 GMT MIME-Version: 1.0 Message-ID: <5a4130f3-4629-4716-a8d2-69f962ac1db9@default> Date: Tue, 11 Feb 2014 07:02:20 -0800 (PST) From: Drew Adams References: <34F77D4702114FF094072B135F951820@us.oracle.com> <87iosoalvy.fsf@building.gnus.org> In-Reply-To: <87iosoalvy.fsf@building.gnus.org> X-Priority: 3 X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.8 (707110) [OL 12.0.6680.5000 (x86)] Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: quoted-printable X-Source-IP: acsinet21.oracle.com [141.146.126.237] X-Spam-Score: -3.0 (---) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.15 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -3.0 (---) > > The doc string talks about the prefix arg, but no connection is > > made to ARGS for use in Lisp. >=20 > 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. >=20 > I don't know. Should these values be documented or not? Of course. From unknown Fri Sep 19 21:29:42 2025 X-Loop: help-debbugs@gnu.org Subject: bug#10346: 24.0.92; doc string of `save-buffer' Resent-From: Lars Ingebrigtsen Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Thu, 28 Apr 2016 12:00: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: To: "Drew Adams" Cc: 10346@debbugs.gnu.org Received: via spool by 10346-submit@debbugs.gnu.org id=B10346.146184474413256 (code B ref 10346); Thu, 28 Apr 2016 12:00:02 +0000 Received: (at 10346) by debbugs.gnu.org; 28 Apr 2016 11:59:04 +0000 Received: from localhost ([127.0.0.1]:51418 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1avkay-0003RG-V2 for submit@debbugs.gnu.org; Thu, 28 Apr 2016 07:59:04 -0400 Received: from hermes.netfonds.no ([80.91.224.195]:36682) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1avkau-0003R3-I1 for 10346@debbugs.gnu.org; Thu, 28 Apr 2016 07:59:00 -0400 Received: from cm-84.215.1.64.getinternet.no ([84.215.1.64] helo=mouse) by hermes.netfonds.no with esmtpsa (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.84_2) (envelope-from ) id 1avkap-0002Ve-QB; Thu, 28 Apr 2016 13:58:55 +0200 From: Lars Ingebrigtsen References: <34F77D4702114FF094072B135F951820@us.oracle.com> <87iosoalvy.fsf@building.gnus.org> Date: Thu, 28 Apr 2016 13:58:51 +0200 In-Reply-To: <87iosoalvy.fsf@building.gnus.org> (Lars Ingebrigtsen's message of "Sat, 08 Feb 2014 21:35:45 -0800") Message-ID: <87shy6lzb8.fsf@gnus.org> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/25.1.50 (gnu/linux) MIME-Version: 1.0 Content-Type: text/plain X-Spam-Score: 0.0 (/) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: 0.0 (/) Lars Ingebrigtsen writes: >> 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? I think they're left out on purpose. Closing. -- (domestic pets only, the antidote for overdose, milk.) bloggy blog: http://lars.ingebrigtsen.no From debbugs-submit-bounces@debbugs.gnu.org Thu Apr 28 07:59:04 2016 Received: (at control) by debbugs.gnu.org; 28 Apr 2016 11:59:04 +0000 Received: from localhost ([127.0.0.1]:51421 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1avkb2-0003Rl-Kp for submit@debbugs.gnu.org; Thu, 28 Apr 2016 07:59:04 -0400 Received: from hermes.netfonds.no ([80.91.224.195]:36689) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1avkb0-0003Ra-Pl for control@debbugs.gnu.org; Thu, 28 Apr 2016 07:59:03 -0400 Received: from cm-84.215.1.64.getinternet.no ([84.215.1.64] helo=mouse) by hermes.netfonds.no with esmtpsa (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.84_2) (envelope-from ) id 1avkay-0002W2-Bp for control@debbugs.gnu.org; Thu, 28 Apr 2016 13:59:02 +0200 Date: Thu, 28 Apr 2016 13:58:58 +0200 Message-Id: <87r3dqlzb1.fsf@gnus.org> To: control@debbugs.gnu.org From: Lars Ingebrigtsen Subject: control message for bug #10346 X-Spam-Score: 0.0 (/) X-Debbugs-Envelope-To: control X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: 0.0 (/) tags 10346 wontfix close 10346 From unknown Fri Sep 19 21:29:42 2025 X-Loop: help-debbugs@gnu.org Subject: bug#10346: 24.0.92; doc string of `save-buffer' Resent-From: Drew Adams Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Thu, 28 Apr 2016 14:14:01 +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: wontfix To: Lars Ingebrigtsen Cc: 10346@debbugs.gnu.org Received: via spool by 10346-submit@debbugs.gnu.org id=B10346.14618528131432 (code B ref 10346); Thu, 28 Apr 2016 14:14:01 +0000 Received: (at 10346) by debbugs.gnu.org; 28 Apr 2016 14:13:33 +0000 Received: from localhost ([127.0.0.1]:53198 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1avmh8-0000Mz-1M for submit@debbugs.gnu.org; Thu, 28 Apr 2016 10:13:33 -0400 Received: from userp1040.oracle.com ([156.151.31.81]:30674) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1avmh2-0000Mf-V1 for 10346@debbugs.gnu.org; Thu, 28 Apr 2016 10:13:29 -0400 Received: from userv0021.oracle.com (userv0021.oracle.com [156.151.31.71]) by userp1040.oracle.com (Sentrion-MTA-4.3.2/Sentrion-MTA-4.3.2) with ESMTP id u3SEDJSi022113 (version=TLSv1 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK); Thu, 28 Apr 2016 14:13:19 GMT Received: from userv0121.oracle.com (userv0121.oracle.com [156.151.31.72]) by userv0021.oracle.com (8.13.8/8.13.8) with ESMTP id u3SEDJc8004447 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK); Thu, 28 Apr 2016 14:13:19 GMT Received: from abhmp0005.oracle.com (abhmp0005.oracle.com [141.146.116.11]) by userv0121.oracle.com (8.13.8/8.13.8) with ESMTP id u3SEDH0J002044; Thu, 28 Apr 2016 14:13:18 GMT MIME-Version: 1.0 Message-ID: <5ab7a55c-4be2-4bed-ab19-7e26b7f5757a@default> Date: Thu, 28 Apr 2016 07:13:15 -0700 (PDT) From: Drew Adams References: <34F77D4702114FF094072B135F951820@us.oracle.com> <87iosoalvy.fsf@building.gnus.org> <87shy6lzb8.fsf@gnus.org> In-Reply-To: <87shy6lzb8.fsf@gnus.org> X-Priority: 3 X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.9 (901082) [OL 12.0.6744.5000 (x86)] Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: quoted-printable X-Source-IP: userv0021.oracle.com [156.151.31.71] X-Spam-Score: -3.3 (---) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -3.3 (---) > Lars Ingebrigtsen writes: >=20 > >> The doc string talks about the prefix arg, but no connection is made t= o > >> 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? >=20 > I think they're left out on purpose. Closing. Do you realize that you answered your own question? This is a command. Interactively, ARG is the numeric prefix arg. This should be stated in the doc string: What ARG is for and how it is used.