From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED!not-for-mail From: Chunyang Xu Newsgroups: gmane.emacs.bugs Subject: bug#24362: 25.1.50; Inconsistent docstring between pcase-let and pcase-let* Date: Sun, 04 Sep 2016 12:26:05 +0800 Message-ID: NNTP-Posting-Host: blaine.gmane.org Mime-Version: 1.0 Content-Type: text/plain X-Trace: blaine.gmane.org 1472963239 20517 195.159.176.226 (4 Sep 2016 04:27:19 GMT) X-Complaints-To: usenet@blaine.gmane.org NNTP-Posting-Date: Sun, 4 Sep 2016 04:27:19 +0000 (UTC) To: 24362@debbugs.gnu.org Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Sun Sep 04 06:27:15 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 1bgP1W-0004oT-TM for geb-bug-gnu-emacs@m.gmane.org; Sun, 04 Sep 2016 06:27:15 +0200 Original-Received: from localhost ([::1]:48706 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1bgP1U-0000cl-LQ for geb-bug-gnu-emacs@m.gmane.org; Sun, 04 Sep 2016 00:27:12 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:33866) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1bgP1O-0000bf-Ss for bug-gnu-emacs@gnu.org; Sun, 04 Sep 2016 00:27:07 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1bgP1K-0006Hb-Kv for bug-gnu-emacs@gnu.org; Sun, 04 Sep 2016 00:27:05 -0400 Original-Received: from debbugs.gnu.org ([208.118.235.43]:51363) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1bgP1K-0006HX-H9 for bug-gnu-emacs@gnu.org; Sun, 04 Sep 2016 00:27:02 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1bgP1K-0002z9-8e for bug-gnu-emacs@gnu.org; Sun, 04 Sep 2016 00:27:02 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Chunyang Xu Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sun, 04 Sep 2016 04:27:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 24362 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: X-Debbugs-Original-To: bug-gnu-emacs@gnu.org Original-Received: via spool by submit@debbugs.gnu.org id=B.147296319611436 (code B ref -1); Sun, 04 Sep 2016 04:27:02 +0000 Original-Received: (at submit) by debbugs.gnu.org; 4 Sep 2016 04:26:36 +0000 Original-Received: from localhost ([127.0.0.1]:49075 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1bgP0t-0002yN-O0 for submit@debbugs.gnu.org; Sun, 04 Sep 2016 00:26:35 -0400 Original-Received: from eggs.gnu.org ([208.118.235.92]:42840) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1bgP0s-0002yB-2v for submit@debbugs.gnu.org; Sun, 04 Sep 2016 00:26:34 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1bgP0m-0006F8-4m for submit@debbugs.gnu.org; Sun, 04 Sep 2016 00:26:29 -0400 Original-Received: from lists.gnu.org ([2001:4830:134:3::11]:47510) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1bgP0m-0006Ez-1T for submit@debbugs.gnu.org; Sun, 04 Sep 2016 00:26:28 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:33798) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1bgP0k-0000ZU-33 for bug-gnu-emacs@gnu.org; Sun, 04 Sep 2016 00:26:26 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1bgP0f-0006EV-RR for bug-gnu-emacs@gnu.org; Sun, 04 Sep 2016 00:26:24 -0400 Original-Received: from mail-pf0-x235.google.com ([2607:f8b0:400e:c00::235]:34115) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1bgP0f-0006ER-LF for bug-gnu-emacs@gnu.org; Sun, 04 Sep 2016 00:26:21 -0400 Original-Received: by mail-pf0-x235.google.com with SMTP id p64so54619788pfb.1 for ; Sat, 03 Sep 2016 21:26:21 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=from:to:subject:date:message-id:mime-version; bh=UIpPVlwicR9tAnTOtHxOR+/C2NUhhLLSM4aLpQzagiw=; b=vA+X9AvnufY04x6HQEWdvEXRChVXXlMEiVyd0TEgietltB9ynHXd2oqbCJn0njhSAn jjYjwzCbBuFA9Rz9DRshpXKsjXBX+P5g8VLGbXxxpEetnkQ4dJTzt773vwh23V8Q+9sm 06AvDa3UFWOgtgfygy1rd+uZbcVLzOo2Af6idlRZP2/gtOPsGa31GoXAn9G0eVIasadG iRSKZUC6FrQXR4kziQdT5Y+klNo2sBJ8yXY0IuD1Pz/rhwYRCFzIPLes9vS1mDLMlzIs c7t4Gd0rPF2ShCuHFe+ZkPQ2PkrlHhAa3tKrn2MFyZ7eDnWbMutZX7gbOFr1rPOjikiT vHeA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20130820; h=x-gm-message-state:from:to:subject:date:message-id:mime-version; bh=UIpPVlwicR9tAnTOtHxOR+/C2NUhhLLSM4aLpQzagiw=; b=m+O2VdYAJ91LuX4Ybw89xLo9CJhmyF7bnBTUprbN/lbj5W7Mnr68jPcwePRYuV/QbD Zl14FFaxWbg5wBFCqUuCqlESZMG/ZUJohP3CrSMFQoUk8Gl7tXA/lrHBG1WQq33zTrY4 hj83JkN388BcaAjY5+AVvN6PFE/owARB8HJEy/c3UQmGuesLwLSN36OM33911mj8DCHl 8VLuK89k+w7gZ1gjfmbG3xAsI+sAY0kwm3f0mMn3GyVLfdPVo93Pjju7bVJyacfz2F41 fOD8285pTMK1tethrAa+Cdt6IZbDSqAgOhErjFyubpdt4agfoPDYMz/z8NwBhRYzngEm MEBA== X-Gm-Message-State: AE9vXwMRQXu9JCYfS1NsobA1wq4pawK8ZfimF8MNGWnmTjzkeoHsXJGrE25CmRRmFT8Abg== X-Received: by 10.98.69.201 with SMTP id n70mr51615477pfi.64.1472963180428; Sat, 03 Sep 2016 21:26:20 -0700 (PDT) Original-Received: from localhost ([47.88.9.6]) by smtp.gmail.com with ESMTPSA id l128sm24834637pfl.21.2016.09.03.21.26.19 for (version=TLS1_2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128); Sat, 03 Sep 2016 21:26:19 -0700 (PDT) X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6.x 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:122921 Archived-At: It looks like, to me, the structure of the BODY arg of these two should be the same (accepting a list froms). (pcase-let ((a 1)) (incf a) a) => 2 (pcase-let* ((a 1)) (incf a) a) => 2 but the docstrings are using the different words. (pcase-let BINDINGS &rest BODY) Like `let' but where you can use `pcase' patterns for bindings. BODY should be a list of expressions, and BINDINGS should be a list of bindings ^^^^^^^^^^^^^^^^^^^^^ of the form (PAT EXP). (pcase-let* BINDINGS &rest BODY) Like `let*' but where you can use `pcase' patterns for bindings. BODY should be an expression, and BINDINGS should be a list of bindings ^^^^^^^^^^^^^ of the form (PAT EXP).