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#24014: 24.5; doc string of `cl-reduce' Date: Mon, 18 Jul 2016 10:28:44 -0700 (PDT) Message-ID: <0c016a2e-daa4-48a8-9bb0-91b66a1ea7d7@default> References: <18e97f8d-f6f8-4b4c-9d4c-20eb8664483e@default> <87zipgmf51.fsf@web.de> <578C993D.10507@gmail.com> <791de973-6bb2-4bd3-a375-b6866e594ad2@default> <578CFDB4.1050302@gmail.com> NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable X-Trace: ger.gmane.org 1468863545 16622 80.91.229.3 (18 Jul 2016 17:39:05 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Mon, 18 Jul 2016 17:39:05 +0000 (UTC) To: =?UTF-8?Q?Cl=C3=A9ment?= Pit--Claudel , 24014@debbugs.gnu.org Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Mon Jul 18 19:38:52 2016 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 1bPCVH-00023R-E4 for geb-bug-gnu-emacs@m.gmane.org; Mon, 18 Jul 2016 19:38:51 +0200 Original-Received: from localhost ([::1]:49331 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1bPCVG-00028S-Er for geb-bug-gnu-emacs@m.gmane.org; Mon, 18 Jul 2016 13:38:50 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:52804) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1bPCMo-00064k-Ey for bug-gnu-emacs@gnu.org; Mon, 18 Jul 2016 13:30:07 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1bPCMl-0005Lb-7X for bug-gnu-emacs@gnu.org; Mon, 18 Jul 2016 13:30:06 -0400 Original-Received: from debbugs.gnu.org ([208.118.235.43]:43624) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1bPCMl-0005LX-41 for bug-gnu-emacs@gnu.org; Mon, 18 Jul 2016 13:30:03 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1bPCMk-0003ls-Uv for bug-gnu-emacs@gnu.org; Mon, 18 Jul 2016 13:30:02 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Drew Adams Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Mon, 18 Jul 2016 17:30:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 24014 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: Original-Received: via spool by 24014-submit@debbugs.gnu.org id=B24014.146886294714395 (code B ref 24014); Mon, 18 Jul 2016 17:30:02 +0000 Original-Received: (at 24014) by debbugs.gnu.org; 18 Jul 2016 17:29:07 +0000 Original-Received: from localhost ([127.0.0.1]:55961 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1bPCLr-0003k7-M4 for submit@debbugs.gnu.org; Mon, 18 Jul 2016 13:29:07 -0400 Original-Received: from aserp1040.oracle.com ([141.146.126.69]:27769) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1bPCLo-0003jb-Ak for 24014@debbugs.gnu.org; Mon, 18 Jul 2016 13:29:06 -0400 Original-Received: from aserv0022.oracle.com (aserv0022.oracle.com [141.146.126.234]) by aserp1040.oracle.com (Sentrion-MTA-4.3.2/Sentrion-MTA-4.3.2) with ESMTP id u6IHSvZa032721 (version=TLSv1 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK); Mon, 18 Jul 2016 17:28:57 GMT Original-Received: from userv0121.oracle.com (userv0121.oracle.com [156.151.31.72]) by aserv0022.oracle.com (8.13.8/8.13.8) with ESMTP id u6IHSv9i020849 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK); Mon, 18 Jul 2016 17:28:57 GMT Original-Received: from abhmp0015.oracle.com (abhmp0015.oracle.com [141.146.116.21]) by userv0121.oracle.com (8.13.8/8.13.8) with ESMTP id u6IHSjW9019524; Mon, 18 Jul 2016 17:28:51 GMT In-Reply-To: <578CFDB4.1050302@gmail.com> X-Priority: 3 X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.9 (901082) [OL 12.0.6744.5000 (x86)] X-Source-IP: aserv0022.oracle.com [141.146.126.234] X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 208.118.235.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" Xref: news.gmane.org gmane.emacs.bugs:121227 Archived-At: > I wasn't sure about the s[h]ort list; I actually found things more > confusing that way. I wonder why? But OK by me not to shorten. > Should this go in the ELisp manual, or in the docstring? Doesn't matter to me. Maybe the manual is better. And isn't the CL manual the proper manual, not the Elisp manual? IMHO, it would help if manual entries for Common-Lisp emulation stuff had links to the most relevant CLTL2 sections that specify it. E.g., in this case, our CL manual would point here: https://www.cs.cmu.edu/Groups/AI/html/cltl/clm/node143.html. It is appropriate for our CL doc to both (1) point to the Common-Lisp spec for the corresponding thingy and (2) point out any differences between our emulation and the thing it emulates. IMHO, not doing this is not doing our job properly, not helping Emacs-Lisp users use our CL emulation. > No strong feelings about the double arrow, and fine with me for quoting f= . =20 Not quoting f is not an option. If f is a variable bound to a function then (f a b c) raises an error. (This is not Scheme.) (setq b #'car) (b '(1 2 3)) Symbol's function definition is void: b If b is an fboundp symbol then (b '(1 2 3)) =3D> 1. When you pass a function-valued argument to `cl-reduce' it is the boundp value of that _variable_ (symbol arg) that is passed, not the fboundp value of the symbol arg. The only thing that works a bit like what a Scheme user might expect in this regard is the use of a lambda at the head of the list: ((lambda (xs) (car xs)) '(1 2 3)) =3D 1.