From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED!not-for-mail From: Drew Adams Newsgroups: gmane.emacs.bugs Subject: bug#24362: 25.1.50; Inconsistent docstring between pcase-let and pcase-let* Date: Thu, 15 Sep 2016 15:00:15 -0700 (PDT) Message-ID: <874c9f9a-631e-4cfc-8301-f9279228e121@default> References: <87fup2nkry.fsf@cochranmail.com> <87k2ecalre.fsf@web.de> NNTP-Posting-Host: blaine.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable X-Trace: blaine.gmane.org 1473976884 6806 195.159.176.226 (15 Sep 2016 22:01:24 GMT) X-Complaints-To: usenet@blaine.gmane.org NNTP-Posting-Date: Thu, 15 Sep 2016 22:01:24 +0000 (UTC) Cc: Chunyang Xu , 24362@debbugs.gnu.org To: Michael Heerdegen , Robert Cochran Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Fri Sep 16 00:01:19 2016 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([208.118.235.17]) by blaine.gmane.org with esmtp (Exim 4.84_2) (envelope-from ) id 1bkeia-00012e-VE for geb-bug-gnu-emacs@m.gmane.org; Fri, 16 Sep 2016 00:01:17 +0200 Original-Received: from localhost ([::1]:37621 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1bkeiZ-0002IL-0Q for geb-bug-gnu-emacs@m.gmane.org; Thu, 15 Sep 2016 18:01:15 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:47238) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1bkeiR-0002I7-R9 for bug-gnu-emacs@gnu.org; Thu, 15 Sep 2016 18:01:09 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1bkeiM-0004I0-RY for bug-gnu-emacs@gnu.org; Thu, 15 Sep 2016 18:01:06 -0400 Original-Received: from debbugs.gnu.org ([208.118.235.43]:34887) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1bkeiM-0004Hi-Oy for bug-gnu-emacs@gnu.org; Thu, 15 Sep 2016 18:01:02 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1bkeiM-0001f4-Bl for bug-gnu-emacs@gnu.org; Thu, 15 Sep 2016 18:01: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: Thu, 15 Sep 2016 22:01:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 24362 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: Original-Received: via spool by 24362-submit@debbugs.gnu.org id=B24362.14739768396346 (code B ref 24362); Thu, 15 Sep 2016 22:01:02 +0000 Original-Received: (at 24362) by debbugs.gnu.org; 15 Sep 2016 22:00:39 +0000 Original-Received: from localhost ([127.0.0.1]:60832 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1bkehz-0001eH-Ce for submit@debbugs.gnu.org; Thu, 15 Sep 2016 18:00:39 -0400 Original-Received: from userp1040.oracle.com ([156.151.31.81]:32858) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1bkehx-0001e4-7b for 24362@debbugs.gnu.org; Thu, 15 Sep 2016 18:00:37 -0400 Original-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 u8FM0Swl008544 (version=TLSv1 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK); Thu, 15 Sep 2016 22:00:28 GMT Original-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 u8FM0SKv029217 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK); Thu, 15 Sep 2016 22:00:28 GMT Original-Received: from abhmp0019.oracle.com (abhmp0019.oracle.com [141.146.116.25]) by userv0121.oracle.com (8.13.8/8.13.8) with ESMTP id u8FM0GKf027056; Thu, 15 Sep 2016 22:00:27 GMT In-Reply-To: <87k2ecalre.fsf@web.de> X-Priority: 3 X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.9 (901082) [OL 12.0.6753.5000 (x86)] X-Source-IP: userv0021.oracle.com [156.151.31.71] 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:123363 Archived-At: > > This patch changes the pcase-let* docstring to match the pcase-let > > docstring, but IMO I don't think that the phrase 'a list of > > expressions' is exactly the right term for this. That (to me) implies > > that we are wrapping the whole body in a list, which you don't. >=20 > Isn't this just normal "Elisp speak" for a &rest parameter? Sure, the > value of the parameter doesn't appear in the code (only "spliced in") - > but we use this wording all the time. An &rest formal parameter corresponds to a list of actual arguments in the calling sequence. Consider (defun foo (&rest xs) (message "Args: %S" xs)). At runtime, XS is the only argument that you can access by name - the only argument whose value is bound to a variable. And yes, its value at runtime, i.e., in any actual call, is a list. On the other hand, not only (foo 1 2) but also (funcall #'foo 1 2) treat 1 and 2 as actual arguments. The list (1 2) does not appear explicitly in these calling sequences. So if you are talking about `foo's actual arguments for such a call then you can say they are 1 and 2. But if you are talking about the value of the &rest argument XS for such a call then you must say that the value is a list.