From unknown Tue Jun 17 01:49:00 2025 X-Loop: help-debbugs@gnu.org Subject: bug#25462: Out of date doc string for "`". Resent-From: Alan Mackenzie Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Mon, 16 Jan 2017 21:32:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 25462 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: 25462@debbugs.gnu.org X-Debbugs-Original-To: bug-gnu-emacs@gnu.org Received: via spool by submit@debbugs.gnu.org id=B.148460228223460 (code B ref -1); Mon, 16 Jan 2017 21:32:01 +0000 Received: (at submit) by debbugs.gnu.org; 16 Jan 2017 21:31:22 +0000 Received: from localhost ([127.0.0.1]:55951 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1cTEs5-00066K-Ma for submit@debbugs.gnu.org; Mon, 16 Jan 2017 16:31:21 -0500 Received: from eggs.gnu.org ([208.118.235.92]:35401) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1cTEs3-000665-QZ for submit@debbugs.gnu.org; Mon, 16 Jan 2017 16:31:20 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1cTErx-0007bA-OS for submit@debbugs.gnu.org; Mon, 16 Jan 2017 16:31:14 -0500 X-Spam-Checker-Version: SpamAssassin 3.3.2 (2011-06-06) on eggs.gnu.org X-Spam-Level: X-Spam-Status: No, score=0.8 required=5.0 tests=BAYES_50 autolearn=disabled version=3.3.2 Received: from lists.gnu.org ([2001:4830:134:3::11]:44980) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1cTErx-0007b6-Lg for submit@debbugs.gnu.org; Mon, 16 Jan 2017 16:31:13 -0500 Received: from eggs.gnu.org ([2001:4830:134:3::10]:54596) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1cTErw-0004MB-L2 for bug-gnu-emacs@gnu.org; Mon, 16 Jan 2017 16:31:13 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1cTErr-0007Zx-Gs for bug-gnu-emacs@gnu.org; Mon, 16 Jan 2017 16:31:12 -0500 Received: from ocolin.muc.de ([193.149.48.4]:60047 helo=mail.muc.de) by eggs.gnu.org with smtp (Exim 4.71) (envelope-from ) id 1cTErr-0007Za-AL for bug-gnu-emacs@gnu.org; Mon, 16 Jan 2017 16:31:07 -0500 Received: (qmail 58954 invoked by uid 3782); 16 Jan 2017 21:31:05 -0000 Received: from acm.muc.de (p548C6E70.dip0.t-ipconnect.de [84.140.110.112]) by colin.muc.de (tmda-ofmipd) with ESMTP; Mon, 16 Jan 2017 22:31:05 +0100 Received: (qmail 4848 invoked by uid 1000); 16 Jan 2017 21:30:51 -0000 Date: Mon, 16 Jan 2017 21:30:51 +0000 Message-ID: <20170116213051.GB4747@acm.fritz.box> MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline User-Agent: Mutt/1.5.24 (2015-08-30) X-Delivery-Agent: TMDA/1.1.12 (Macallan) From: Alan Mackenzie X-Primary-Address: acm@muc.de X-detected-operating-system: by eggs.gnu.org: FreeBSD 9.x [fuzzy] X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6.x X-Received-From: 2001:4830:134:3::11 X-Spam-Score: -4.4 (----) 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: -4.4 (----) Hello, Emacs. The doc string for "`" has become partial. It fails to mention that "`" has a radically different meaning when used in certain parts of a `pcase', and probably quite a few other similar macros. -- Alan Mackenzie (Nuremberg, Germany). From unknown Tue Jun 17 01:49:00 2025 X-Loop: help-debbugs@gnu.org Subject: bug#25462: Out of date doc string for "`". Resent-From: Noam Postavsky Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Mon, 16 Jan 2017 21:53:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 25462 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: Alan Mackenzie Cc: 25462@debbugs.gnu.org Received: via spool by 25462-submit@debbugs.gnu.org id=B25462.148460356525326 (code B ref 25462); Mon, 16 Jan 2017 21:53:01 +0000 Received: (at 25462) by debbugs.gnu.org; 16 Jan 2017 21:52:45 +0000 Received: from localhost ([127.0.0.1]:55957 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1cTFCn-0006aQ-IS for submit@debbugs.gnu.org; Mon, 16 Jan 2017 16:52:45 -0500 Received: from mail-ot0-f179.google.com ([74.125.82.179]:33213) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1cTFCl-0006a8-A2 for 25462@debbugs.gnu.org; Mon, 16 Jan 2017 16:52:44 -0500 Received: by mail-ot0-f179.google.com with SMTP id 73so51050391otj.0 for <25462@debbugs.gnu.org>; Mon, 16 Jan 2017 13:52:43 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=mime-version:sender:in-reply-to:references:from:date:message-id :subject:to:cc; bh=wBQBmRI78LMcPWjqNS1hT6xWnfPGGRS/88GBNEcfZcE=; b=LWEPa46ypFUxcTXSKvwHC71rIQLvJtjNYWjlZTQ8AkS8QTTY2/zu1zZymwDQW9ZWI/ PSW/M6+TflAp10bJlxQKRtHcRw2YPqVoVyQMg3iHrWvn6HXcNII94l/BSGkSIdRpCG80 PBhgKkKNfD/Gwq+Vo/Tr68pjZoy/BDoMOvFhb55HQySUbfEWEat9okAR3c3mddPbPzjs COcx+k7aL5RRHBeKtrox7X/PAWQ+DD4qYJWlfdQM2LR3YiYluOHb2FTRjktHayhEt8Kn kkQg9qc9E7qefIpgkokpHwm3p2uKaBkFhzXI01wMVBiw522TPsdakqHFgX6uXJVHVp7O +/4A== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:mime-version:sender:in-reply-to:references:from :date:message-id:subject:to:cc; bh=wBQBmRI78LMcPWjqNS1hT6xWnfPGGRS/88GBNEcfZcE=; b=P7x364lgSfO4L/8mqDvZMNRLqXMpWt0KUG0kWqgqur0VTsDuGcfkfSsiBhO+Az3HKG i93617eFd7gAdevgHYzcU4AVNG9Zt6Fxxt8UQcqIhAn7d5CehjrHSdWHO9g8vvTpDKQQ +1ip3YetK1lvaNj/gX9kp0v/uPCbdIEueIMGS9xatz1+CQlsSRcDPdHk0nKzjJrdIwVL XBIDJ5C5YjXH5s2DUwiZuvEM6LnhUYztiQ544LCM/K5Sdc5uW9KDSbCg1wBkXVedl7Jr AZu+WS3EdhDlnMas+6mxZWO9Ds6aKNoti3Qu62pEdJlT2hY4aV/S2yWfbgNRqlx4/5KY OtIg== X-Gm-Message-State: AIkVDXJxTgzHL9WQ81bp31CHtAOVksgCMMgEbRTFzTrIuUCk0cnxpAHHKdXPV1ZTl8PiNQbznMcaOP45LtV1Pw== X-Received: by 10.157.27.154 with SMTP id z26mr12561262otd.181.1484603557278; Mon, 16 Jan 2017 13:52:37 -0800 (PST) MIME-Version: 1.0 Received: by 10.157.21.117 with HTTP; Mon, 16 Jan 2017 13:52:36 -0800 (PST) In-Reply-To: <20170116213051.GB4747@acm.fritz.box> References: <20170116213051.GB4747@acm.fritz.box> From: Noam Postavsky Date: Mon, 16 Jan 2017 16:52:36 -0500 X-Google-Sender-Auth: NN3phNyCy-tXmR8G6jTHlr9M5NE Message-ID: Content-Type: text/plain; charset=UTF-8 X-Spam-Score: 0.5 (/) 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.5 (/) On Mon, Jan 16, 2017 at 4:30 PM, Alan Mackenzie wrote: > Hello, Emacs. > > The doc string for "`" has become partial. > > It fails to mention that "`" has a radically different meaning when used > in certain parts of a `pcase', and probably quite a few other similar > macros. I don't think that makes sense. Similarly, we don't add a mention of `cl-loop's use of `if' in the docstring of `if', because that's not part of the `if' special form. It's just a use of `if' as a plain symbol. From unknown Tue Jun 17 01:49:00 2025 X-Loop: help-debbugs@gnu.org Subject: bug#25462: Out of date doc string for "`". Resent-From: Alan Mackenzie Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Tue, 17 Jan 2017 20:13:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 25462 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: Noam Postavsky Cc: 25462@debbugs.gnu.org Received: via spool by 25462-submit@debbugs.gnu.org id=B25462.14846839611358 (code B ref 25462); Tue, 17 Jan 2017 20:13:01 +0000 Received: (at 25462) by debbugs.gnu.org; 17 Jan 2017 20:12:41 +0000 Received: from localhost ([127.0.0.1]:34071 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1cTa7T-0000Lo-FQ for submit@debbugs.gnu.org; Tue, 17 Jan 2017 15:12:39 -0500 Received: from ocolin.muc.de ([193.149.48.4]:53382 helo=mail.muc.de) by debbugs.gnu.org with smtp (Exim 4.84_2) (envelope-from ) id 1cTa7Q-0000Le-9r for 25462@debbugs.gnu.org; Tue, 17 Jan 2017 15:12:36 -0500 Received: (qmail 1860 invoked by uid 3782); 17 Jan 2017 20:05:54 -0000 Received: from acm.muc.de (p548C72E2.dip0.t-ipconnect.de [84.140.114.226]) by colin.muc.de (tmda-ofmipd) with ESMTP; Tue, 17 Jan 2017 21:05:53 +0100 Received: (qmail 4745 invoked by uid 1000); 17 Jan 2017 20:05:39 -0000 Date: Tue, 17 Jan 2017 20:05:39 +0000 Message-ID: <20170117200539.GB4169@acm.fritz.box> References: <20170116213051.GB4747@acm.fritz.box> MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: User-Agent: Mutt/1.5.24 (2015-08-30) X-Delivery-Agent: TMDA/1.1.12 (Macallan) From: Alan Mackenzie X-Primary-Address: acm@muc.de X-Spam-Score: -3.2 (---) 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.2 (---) Hello, Noam. On Mon, Jan 16, 2017 at 04:52:36PM -0500, Noam Postavsky wrote: > On Mon, Jan 16, 2017 at 4:30 PM, Alan Mackenzie wrote: > > Hello, Emacs. > > The doc string for "`" has become partial. > > It fails to mention that "`" has a radically different meaning when used > > in certain parts of a `pcase', and probably quite a few other similar > > macros. > I don't think that makes sense. Similarly, we don't add a mention of > `cl-loop's use of `if' in the docstring of `if', because that's not > part of the `if' special form. It's just a use of `if' as a plain > symbol. I don't think `if' inside cl-loop is liable to cause much confusion. pcase, on the other hand, does cause confusion, as it radically changes the meaning of symbols contained within it, something that other macros don't do - with the possible minor exception of cl-loop. If you can think of any other such examples of context dependence changing the semantics, I think these should be documented too. The direction I'm coming from is to make the doc strings help users - not to make them 100% consistent. -- Alan Mackenzie (Nuremberg, Germany). From unknown Tue Jun 17 01:49:00 2025 X-Loop: help-debbugs@gnu.org Subject: bug#25462: Out of date doc string for "`". Resent-From: John Mastro Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Tue, 17 Jan 2017 21:18:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 25462 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: 25462@debbugs.gnu.org Cc: Alan Mackenzie , Noam Postavsky Received: via spool by 25462-submit@debbugs.gnu.org id=B25462.14846878767303 (code B ref 25462); Tue, 17 Jan 2017 21:18:02 +0000 Received: (at 25462) by debbugs.gnu.org; 17 Jan 2017 21:17:56 +0000 Received: from localhost ([127.0.0.1]:34108 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1cTb8e-0001tj-L9 for submit@debbugs.gnu.org; Tue, 17 Jan 2017 16:17:56 -0500 Received: from mail-qt0-f175.google.com ([209.85.216.175]:33919) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1cTb8c-0001tU-A4 for 25462@debbugs.gnu.org; Tue, 17 Jan 2017 16:17:55 -0500 Received: by mail-qt0-f175.google.com with SMTP id l7so181311459qtd.1 for <25462@debbugs.gnu.org>; Tue, 17 Jan 2017 13:17:54 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=mime-version:in-reply-to:references:from:date:message-id:subject:to :cc; bh=C1Mt2ucZTrvlR7U7i+ZdcqcBzYB00d+WHG5lek1VMV8=; b=X/EhyMfdz6uJMU5P3ohWi+tXxC48T+kcZhAImfGom7dSwwphDI/8sSnBEpnjNVIiJX MGDjkOZtFrp/KVa0mZNu2Ax6n7VHXce3Od6FjgUNALP6vY0i/NIHK+pbzlXoVUVEW3aO VCuT9xggXlyYlhkUz5cUi3CEqUDn3tU7aq2jmK6g+5EpfDjt0XxfoPu4OF7apkuGnPpS jGHCdMd4wNhSeW2xqLq0eeeLkzwtapRoTRVOx9AQs64JC0h0nyYr6MyWOjHb8LXz1QiM ZsGkf90aSEb04DpD5NOV3xPfJwkIF7sG9Jifchx45KntyaYl3+KfNPySWzaPnh/YxQ/r ysbQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:mime-version:in-reply-to:references:from:date :message-id:subject:to:cc; bh=C1Mt2ucZTrvlR7U7i+ZdcqcBzYB00d+WHG5lek1VMV8=; b=Ecs0RB1SJzeV7chaoqcXCQGsxMzBqui1O8PJ2VIS0ZwuP51GMJ6C3uND/cGeW5j6Dj WI+EEzQ8G3hrvComO5zumN5DXH7EaejRxGetPrCp49kjkmi9jmOOWD5XLTuCGHYD7zx2 mNU+sHkxAWyM8hjwsd4vzqFefocoG/3kHG0M74M+YCniP94ms8GIEc5vg8SPbIZFz/8r pE2PchfdY2GbHIjEZJ3BKGcvPSe7yYOomOIAMrckOkfeqPIKcOBfWlH5RsN8Q+aTDQNP k+AZKs/Ig8UlDec77owR1RAWj5nAxxRPmfm75u0Hs2M89mObcoNgEqQabBxY4TTdS4Kl yNTQ== X-Gm-Message-State: AIkVDXJo7GL77czSF58gEOnvRto6jbunGMOAtU2vaPwPX1Rq/0/0EUlXRi4sTG4doncAafXTAmdLtdim1mvr/g== X-Received: by 10.55.103.85 with SMTP id b82mr35280380qkc.24.1484687868238; Tue, 17 Jan 2017 13:17:48 -0800 (PST) MIME-Version: 1.0 Received: by 10.237.56.138 with HTTP; Tue, 17 Jan 2017 13:17:27 -0800 (PST) In-Reply-To: References: <20170116213051.GB4747@acm.fritz.box> From: John Mastro Date: Tue, 17 Jan 2017 13:17:27 -0800 Message-ID: Content-Type: text/plain; charset=UTF-8 X-Spam-Score: -0.2 (/) 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.2 (/) Noam Postavsky wrote: > On Mon, Jan 16, 2017 at 4:30 PM, Alan Mackenzie wrote: >> Hello, Emacs. >> >> The doc string for "`" has become partial. >> >> It fails to mention that "`" has a radically different meaning when used >> in certain parts of a `pcase', and probably quite a few other similar >> macros. > > I don't think that makes sense. Similarly, we don't add a mention of > `cl-loop's use of `if' in the docstring of `if', because that's not > part of the `if' special form. It's just a use of `if' as a plain > symbol. Since the misunderstanding is believing that "`" is more special than it is, maybe something calling out its ordinariness could be appropriate (and throw in a reference to pcase as an example?) I don't think this is great, but, as an example: Note that `\\=`' is any ordinary Lisp symbol and thus may be treated as data or given different meanings in particular contexts. For instance, it has a special meaning inside `pcase' patterns. From unknown Tue Jun 17 01:49:00 2025 X-Loop: help-debbugs@gnu.org Subject: bug#25462: Out of date doc string for "`". Resent-From: npostavs@users.sourceforge.net Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Wed, 18 Jan 2017 02:04:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 25462 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: Alan Mackenzie Cc: 25462@debbugs.gnu.org Received: via spool by 25462-submit@debbugs.gnu.org id=B25462.1484705032757 (code B ref 25462); Wed, 18 Jan 2017 02:04:02 +0000 Received: (at 25462) by debbugs.gnu.org; 18 Jan 2017 02:03:52 +0000 Received: from localhost ([127.0.0.1]:34187 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1cTfbK-0000C7-Or for submit@debbugs.gnu.org; Tue, 17 Jan 2017 21:03:50 -0500 Received: from mail-it0-f50.google.com ([209.85.214.50]:38816) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1cTfbI-0000Bu-Eq for 25462@debbugs.gnu.org; Tue, 17 Jan 2017 21:03:48 -0500 Received: by mail-it0-f50.google.com with SMTP id c7so1438479itd.1 for <25462@debbugs.gnu.org>; Tue, 17 Jan 2017 18:03:48 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=sender:from:to:cc:subject:references:date:in-reply-to:message-id :user-agent:mime-version; bh=1N1snMcOeFjATak8RAHFafVD9h4+J1yGKBT9TOBXxNQ=; b=Ktkdtqjhz+zrQGkaacr/EuE0UNVfKRhB71/yl5M6kJ/POGFrWKRCFdpKDwervsOz7p RyYessS12A/MNofaKpNIsuVbgX4DrCOLYQADel8TGjYssqV4CymfaGBz3Bd7Cp0go+Zv Y2biLXlM4yogVmyKrkA1nzvF0VjidRD4Ik2KQu2PGuZMIMAID85t2XxxlryfYkPRLnE0 Rhb9qgf8GmBD41fA+fTP71uYiFnOc8GIe3aMOXspGqR764bj3pMsBCAkFevVzc6hGXAQ lM1iPDY0wZrxwKIDA4E1T8R1AoCYTRsncHdmBxbAgwUutd8dHgof42vRQ1bQL+inBhaG bVIA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:sender:from:to:cc:subject:references:date :in-reply-to:message-id:user-agent:mime-version; bh=1N1snMcOeFjATak8RAHFafVD9h4+J1yGKBT9TOBXxNQ=; b=K8lury8Huzg4B0Ifr3DeFGv3SOi29pvXcS+ssOhhgQZD3XPHayBFVq4Xdm7vfdpU5K JLtlwVSnKOoZP9AAQRGhWtPxpkjZdgFp7x3uL6NQ2MtLc/PV8uy7WQUqRQfHtWRvoKuH k5/9IPXQ/JdrOGnyiL6jkdq4GgEZMPRllL9lr7C3Z+VW8pFt8E+QMJobj7RcEncf6YPY QVZ32Rg+SH67snhnTeEvF0m7VqNWVoPZY15xl14tHjs+gjCc7PvZFAY+ZlaJ1aYktAga H2uB3/XZ7ghM5v+8dL41W0KRIqhWmPyYlyOvyWx50HqzjjAGpVRQgJvVoKhLMH8sam7a C3nQ== X-Gm-Message-State: AIkVDXJUj3PY7RMcxzmVsgzkNCP/UIErfXwbzfVO3PLXArTrbnHfWBRox/I/y7gttkFtCQ== X-Received: by 10.36.170.68 with SMTP id y4mr1302233iti.7.1484705022738; Tue, 17 Jan 2017 18:03:42 -0800 (PST) Received: from zony ([45.2.7.65]) by smtp.googlemail.com with ESMTPSA id p20sm8176264itc.2.2017.01.17.18.03.41 (version=TLS1_2 cipher=ECDHE-RSA-CHACHA20-POLY1305 bits=256/256); Tue, 17 Jan 2017 18:03:42 -0800 (PST) From: npostavs@users.sourceforge.net References: <20170116213051.GB4747@acm.fritz.box> <20170117200539.GB4169@acm.fritz.box> Date: Tue, 17 Jan 2017 21:04:48 -0500 In-Reply-To: <20170117200539.GB4169@acm.fritz.box> (Alan Mackenzie's message of "Tue, 17 Jan 2017 20:05:39 +0000") Message-ID: <87y3y9w2bj.fsf@users.sourceforge.net> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/25.1 (gnu/linux) MIME-Version: 1.0 Content-Type: text/plain X-Spam-Score: -0.2 (/) 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.2 (/) Alan Mackenzie writes: > Hello, Noam. > > On Mon, Jan 16, 2017 at 04:52:36PM -0500, Noam Postavsky wrote: >> On Mon, Jan 16, 2017 at 4:30 PM, Alan Mackenzie wrote: >> > Hello, Emacs. > >> > The doc string for "`" has become partial. > >> > It fails to mention that "`" has a radically different meaning when used >> > in certain parts of a `pcase', and probably quite a few other similar >> > macros. > >> I don't think that makes sense. Similarly, we don't add a mention of >> `cl-loop's use of `if' in the docstring of `if', because that's not >> part of the `if' special form. It's just a use of `if' as a plain >> symbol. > > I don't think `if' inside cl-loop is liable to cause much confusion. > pcase, on the other hand, does cause confusion, as it radically changes > the meaning of symbols contained within it, something that other macros > don't do - with the possible minor exception of cl-loop. > > If you can think of any other such examples of context dependence > changing the semantics, I think these should be documented too. `rx' gives new semantics to `and', `or', `any', etc... `condition-case' changes the meaning of the symbol list at the front of its handlers. At one point, the `use-package' macro (note, this is not (yet) part of Emacs) interpreted `,' to mean eager evaluation. But people didn't like it, so it now uses `lambda' for that instead. > The direction I'm coming from is to make the doc strings help users - > not to make them 100% consistent. Well, I guess adding a mention of pcase in backquote's docstring would be okay. The way your initial report phrases it, as if the docstring is incomplete without that, didn't make sense to me. From unknown Tue Jun 17 01:49:00 2025 X-Loop: help-debbugs@gnu.org Subject: bug#25462: Out of date doc string for "`". Resent-From: Alan Mackenzie Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Wed, 18 Jan 2017 20:41:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 25462 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: Noam Postavsky Cc: 25462@debbugs.gnu.org Received: via spool by 25462-submit@debbugs.gnu.org id=B25462.148477202621051 (code B ref 25462); Wed, 18 Jan 2017 20:41:01 +0000 Received: (at 25462) by debbugs.gnu.org; 18 Jan 2017 20:40:26 +0000 Received: from localhost ([127.0.0.1]:35018 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1cTx1u-0005TT-ET for submit@debbugs.gnu.org; Wed, 18 Jan 2017 15:40:26 -0500 Received: from ocolin.muc.de ([193.149.48.4]:37276 helo=mail.muc.de) by debbugs.gnu.org with smtp (Exim 4.84_2) (envelope-from ) id 1cTx1s-0005TL-Ti for 25462@debbugs.gnu.org; Wed, 18 Jan 2017 15:40:25 -0500 Received: (qmail 3498 invoked by uid 3782); 18 Jan 2017 20:40:23 -0000 Received: from acm.muc.de (p548C6FB5.dip0.t-ipconnect.de [84.140.111.181]) by colin.muc.de (tmda-ofmipd) with ESMTP; Wed, 18 Jan 2017 21:40:22 +0100 Received: (qmail 5585 invoked by uid 1000); 18 Jan 2017 20:40:08 -0000 Date: Wed, 18 Jan 2017 20:40:08 +0000 Message-ID: <20170118204008.GE4108@acm.fritz.box> References: <20170116213051.GB4747@acm.fritz.box> MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: User-Agent: Mutt/1.5.24 (2015-08-30) X-Delivery-Agent: TMDA/1.1.12 (Macallan) From: Alan Mackenzie X-Primary-Address: acm@muc.de X-Spam-Score: -3.2 (---) 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.2 (---) Hello again, Noam. On Mon, Jan 16, 2017 at 04:52:36PM -0500, Noam Postavsky wrote: > On Mon, Jan 16, 2017 at 4:30 PM, Alan Mackenzie wrote: > > Hello, Emacs. > > The doc string for "`" has become partial. > > It fails to mention that "`" has a radically different meaning when used > > in certain parts of a `pcase', and probably quite a few other similar > > macros. > I don't think that makes sense. Similarly, we don't add a mention of > `cl-loop's use of `if' in the docstring of `if', because that's not > part of the `if' special form. It's just a use of `if' as a plain > symbol. In cl-loop, you might have "if", but you're never going to have "(if ...", are you? If this is correct, then `if' is not used in a way that could be confused with the special form. This doesn't apply to ` as used in pcase. -- Alan Mackenzie (Nuremberg, Germany). From unknown Tue Jun 17 01:49:00 2025 X-Loop: help-debbugs@gnu.org Subject: bug#25462: Out of date doc string for "`". Resent-From: Alan Mackenzie Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Wed, 18 Jan 2017 20:56:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 25462 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: John Mastro Cc: 25462@debbugs.gnu.org, Noam Postavsky Received: via spool by 25462-submit@debbugs.gnu.org id=B25462.148477294422388 (code B ref 25462); Wed, 18 Jan 2017 20:56:02 +0000 Received: (at 25462) by debbugs.gnu.org; 18 Jan 2017 20:55:44 +0000 Received: from localhost ([127.0.0.1]:35022 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1cTxGh-0005p2-QC for submit@debbugs.gnu.org; Wed, 18 Jan 2017 15:55:43 -0500 Received: from ocolin.muc.de ([193.149.48.4]:50199 helo=mail.muc.de) by debbugs.gnu.org with smtp (Exim 4.84_2) (envelope-from ) id 1cTxGg-0005ou-36 for 25462@debbugs.gnu.org; Wed, 18 Jan 2017 15:55:42 -0500 Received: (qmail 6731 invoked by uid 3782); 18 Jan 2017 20:55:40 -0000 Received: from acm.muc.de (p548C6FB5.dip0.t-ipconnect.de [84.140.111.181]) by colin.muc.de (tmda-ofmipd) with ESMTP; Wed, 18 Jan 2017 21:55:39 +0100 Received: (qmail 5614 invoked by uid 1000); 18 Jan 2017 20:55:25 -0000 Date: Wed, 18 Jan 2017 20:55:25 +0000 Message-ID: <20170118205525.GF4108@acm.fritz.box> References: <20170116213051.GB4747@acm.fritz.box> MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: User-Agent: Mutt/1.5.24 (2015-08-30) X-Delivery-Agent: TMDA/1.1.12 (Macallan) From: Alan Mackenzie X-Primary-Address: acm@muc.de X-Spam-Score: -3.2 (---) 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.2 (---) Hello, John. On Tue, Jan 17, 2017 at 01:17:27PM -0800, John Mastro wrote: > Noam Postavsky wrote: > > On Mon, Jan 16, 2017 at 4:30 PM, Alan Mackenzie wrote: > >> Hello, Emacs. > >> The doc string for "`" has become partial. > >> It fails to mention that "`" has a radically different meaning when used > >> in certain parts of a `pcase', and probably quite a few other similar > >> macros. > > I don't think that makes sense. Similarly, we don't add a mention of > > `cl-loop's use of `if' in the docstring of `if', because that's not > > part of the `if' special form. It's just a use of `if' as a plain > > symbol. > Since the misunderstanding is believing that "`" is more special than it > is, maybe something calling out its ordinariness could be appropriate > (and throw in a reference to pcase as an example?) "`" is very special. So special, indeed, that its syntax is handled by the Lisp reader. > I don't think this is great, but, as an example: > Note that `\\=`' is any ordinary Lisp symbol and thus may be treated > as data or given different meanings in particular contexts. For > instance, it has a special meaning inside `pcase' patterns. I think that's objectively wrong. "`" isn't an ordinary Lisp symbol, it's a reader macro which is handled in the reader. There aren't many of these macros, and only a very few in normal use. Besides, we don't want to encourage people to reuse existing symbols for unconnected purposes. -- Alan Mackenzie (Nuremberg, Germany). From unknown Tue Jun 17 01:49:00 2025 X-Loop: help-debbugs@gnu.org Subject: bug#25462: Out of date doc string for "`". Resent-From: Noam Postavsky Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Wed, 18 Jan 2017 22:15:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 25462 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: Alan Mackenzie Cc: John Mastro , 25462@debbugs.gnu.org Received: via spool by 25462-submit@debbugs.gnu.org id=B25462.148477765929525 (code B ref 25462); Wed, 18 Jan 2017 22:15:01 +0000 Received: (at 25462) by debbugs.gnu.org; 18 Jan 2017 22:14:19 +0000 Received: from localhost ([127.0.0.1]:35054 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1cTyUl-0007g9-Km for submit@debbugs.gnu.org; Wed, 18 Jan 2017 17:14:19 -0500 Received: from mail-ot0-f170.google.com ([74.125.82.170]:34572) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1cTyUj-0007fv-5Q for 25462@debbugs.gnu.org; Wed, 18 Jan 2017 17:14:18 -0500 Received: by mail-ot0-f170.google.com with SMTP id f9so19086327otd.1 for <25462@debbugs.gnu.org>; Wed, 18 Jan 2017 14:14:17 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=mime-version:sender:in-reply-to:references:from:date:message-id :subject:to:cc; bh=W98g7I/TU5C0F9/I3wzHJgxGSKzdRaw3MXNgw013uK4=; b=QvxLSxUTfODLw+3woZLYxeiZw3S/F7f0z1I3vxAO0U1DQCYljDS/2ewXFrHJB8oRvT hAAZKryW55gd84aYHAFQvtgrNiX9Ww5RrnZvjUqun3IIscwfLXogDmyUQAOwXuCqHJkZ +bER3blWAMJElEmiCxJ/xLLRFyydrYCRCm8XvA9Z938ITkHFQGdB4y9rt79d/JhjGDkS rJ5wAnw5GUTrBzSZ1G2aNjZ6uCgxQZiocExJZIgpK+DiMSE0DGagvwyAbI3X2UWn9Aat QRCzD6Muw2WqR0jbSqPdMWPbdW01SsZvoAFSpm89w5YHGuO16CIop0Q4cbGIuZSAhyv9 YJqg== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:mime-version:sender:in-reply-to:references:from :date:message-id:subject:to:cc; bh=W98g7I/TU5C0F9/I3wzHJgxGSKzdRaw3MXNgw013uK4=; b=IysbNKcb7L83C5y9Gtx0j0Zss7qtYXOEq5hnCC5O5QKjnFVubAROfmGH64ASt+m02Y nX7lbllaYTo4L4t05VOgqpvXPQUUAyWifAyruuJoZ6SDYX9XCCuVyhdH9NmRYPJHoQwK uJpUvh1Ve4kF9MRut7Zqt/npUf6tYsqkqghzSGUC5izX6eA8F8TJYbQKt12Nzz1i00B3 wivRgU3ce43mjjIqqXIA8Y9uko2itS1fIlQNqWg4OepwEwuCId+m+AN0pX7/ixc2X7Ez gd2EI2hJJv8Wrz0D914i1XOZAcrbcC0MhzApdgokyRmj3kolDuZdjKFIo6v1Rd8cAHTz 7Hiw== X-Gm-Message-State: AIkVDXIQ7ch6CM/mXIB0CLfsQGFoFF1SqWoovlZK3Zig7pR9Wz5ygPItncQINRN6IoGcbxVa4p7aBt1fC52x2g== X-Received: by 10.157.62.203 with SMTP id b69mr2697100otc.30.1484777651458; Wed, 18 Jan 2017 14:14:11 -0800 (PST) MIME-Version: 1.0 Received: by 10.157.21.117 with HTTP; Wed, 18 Jan 2017 14:14:10 -0800 (PST) In-Reply-To: <20170118205525.GF4108@acm.fritz.box> References: <20170116213051.GB4747@acm.fritz.box> <20170118205525.GF4108@acm.fritz.box> From: Noam Postavsky Date: Wed, 18 Jan 2017 17:14:10 -0500 X-Google-Sender-Auth: -eI2UO7J9YLPhbjX8BHir40I-lQ Message-ID: Content-Type: text/plain; charset=UTF-8 X-Spam-Score: 0.5 (/) 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.5 (/) On Wed, Jan 18, 2017 at 3:55 PM, Alan Mackenzie wrote: > >> Note that `\\=`' is any ordinary Lisp symbol and thus may be treated >> as data or given different meanings in particular contexts. For >> instance, it has a special meaning inside `pcase' patterns. > > I think that's objectively wrong. It's correct. > "`" isn't an ordinary Lisp symbol, > it's a reader macro which is handled in the reader. It's both. "`" is a reader macro which expands into a list starting with the ordinary Lisp symbol named "`". (equal (car (read-from-string "`a")) (list (intern "`") 'a)) ;=> t From unknown Tue Jun 17 01:49:00 2025 X-Loop: help-debbugs@gnu.org Subject: bug#25462: Out of date doc string for "`". Resent-From: Stefan Kangas Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sat, 25 Sep 2021 16:13:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 25462 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: Alan Mackenzie Cc: 25462@debbugs.gnu.org Received: via spool by 25462-submit@debbugs.gnu.org id=B25462.16325863693511 (code B ref 25462); Sat, 25 Sep 2021 16:13:02 +0000 Received: (at 25462) by debbugs.gnu.org; 25 Sep 2021 16:12:49 +0000 Received: from localhost ([127.0.0.1]:34475 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1mUAID-0000uY-5C for submit@debbugs.gnu.org; Sat, 25 Sep 2021 12:12:49 -0400 Received: from mail-pf1-f178.google.com ([209.85.210.178]:42723) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1mUAI7-0000u0-RW for 25462@debbugs.gnu.org; Sat, 25 Sep 2021 12:12:44 -0400 Received: by mail-pf1-f178.google.com with SMTP id q23so11585420pfs.9 for <25462@debbugs.gnu.org>; Sat, 25 Sep 2021 09:12:43 -0700 (PDT) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=x-gm-message-state:from:in-reply-to:references:user-agent :mime-version:date:message-id:subject:to:cc; bh=jzD0T36UEXD2pgslbcHBxDlLhCmQrVtJFds2PU1qsTA=; b=VEl3YyZxMGuAfzbxiaiZ0HK1fCbrAqpvEG/PDZN07WQY4cj3KovtcujQRIgUBFmKEH bQDIIiv3S7zIpWAvCFJ8yESI8dxB6wYT2qNBGyPr5ArjLW53R3NghWZHhI+rHb/rmfRL Bb0EUTdOjmGQklRbk5fNr0f17f0CNlMzFi6H9o1K5DPfXEO9apvqBkSKI/QMMO3y7umH M1hxjXvjzDRVYWjUhsXgFCaNJ/DbtZqvY3cECODv+HmZCXB2N3JT6C5CBAcg+eG+xjG6 9ZvR3DLQH/yYGMkoAl1CaDTPTevCGqfDKHypRTN1fKz/9lmkZAdTLgZuQMeI3+nShDWC sdIQ== X-Gm-Message-State: AOAM5305YoutYZreRudZx6UaZZBgWsC4usRMHj6uK2uor3FzCF/FWD4I AhHQVSTj/jzAFhvvjflkrYVVcxOrZE3Q4/Uvil1dLSlg X-Google-Smtp-Source: ABdhPJxkBEnfL7lTJcxUNVP0ZLCuya8gFJP/2/7eZ/mcSO37xYfwkmeJCyeEPmiAJh7eL+9OC1uAGiYeeDLw63vfqg8= X-Received: by 2002:a05:6a00:1586:b0:447:b30c:4a65 with SMTP id u6-20020a056a00158600b00447b30c4a65mr15007488pfk.0.1632586358246; Sat, 25 Sep 2021 09:12:38 -0700 (PDT) Received: from 753933720722 named unknown by gmailapi.google.com with HTTPREST; Sat, 25 Sep 2021 09:12:37 -0700 From: Stefan Kangas In-Reply-To: <20170116213051.GB4747@acm.fritz.box> (Alan Mackenzie's message of "Mon, 16 Jan 2017 21:30:51 +0000") References: <20170116213051.GB4747@acm.fritz.box> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/28.0.50 (gnu/linux) MIME-Version: 1.0 Date: Sat, 25 Sep 2021 09:12:37 -0700 Message-ID: Content-Type: text/plain; charset="UTF-8" X-Spam-Score: 0.5 (/) 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.5 (/) Alan Mackenzie writes: > Hello, Emacs. > > The doc string for "`" has become partial. > > It fails to mention that "`" has a radically different meaning when used > in certain parts of a `pcase', and probably quite a few other similar > macros. How about adding this at the very end of the ` docstring: Note that some macros, such as `pcase', change the meaning of this symbol. From unknown Tue Jun 17 01:49:00 2025 X-Loop: help-debbugs@gnu.org Subject: bug#25462: Out of date doc string for "`". Resent-From: Lars Ingebrigtsen Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sun, 26 Sep 2021 06:47:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 25462 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: Stefan Kangas Cc: Alan Mackenzie , 25462@debbugs.gnu.org Received: via spool by 25462-submit@debbugs.gnu.org id=B25462.16326388059874 (code B ref 25462); Sun, 26 Sep 2021 06:47:01 +0000 Received: (at 25462) by debbugs.gnu.org; 26 Sep 2021 06:46:45 +0000 Received: from localhost ([127.0.0.1]:35586 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1mUNvw-0002Z0-UK for submit@debbugs.gnu.org; Sun, 26 Sep 2021 02:46:45 -0400 Received: from quimby.gnus.org ([95.216.78.240]:47792) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1mUNvu-0002T6-V3 for 25462@debbugs.gnu.org; Sun, 26 Sep 2021 02:46:43 -0400 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=gnus.org; s=20200322; h=Content-Type:MIME-Version:Message-ID:In-Reply-To:Date: References:Subject:Cc:To:From:Sender:Reply-To:Content-Transfer-Encoding: Content-ID:Content-Description:Resent-Date:Resent-From:Resent-Sender: Resent-To:Resent-Cc:Resent-Message-ID:List-Id:List-Help:List-Unsubscribe: List-Subscribe:List-Post:List-Owner:List-Archive; bh=znL+XNCGkIU3bxluVwuG0G2vC8vfIP6hGcHW9B9ycTc=; b=qvQWalrIsZoOP+2vPYZrIc1A4r lofqlrpjNlp3sN2N979xxT1GT8w+NI4E1tGMbLLttoFokBTY5vs5PUQQOOlPPhvyNY2FmCYIA4X2G KeGKAlM1O+j4N3M+6ovVIkiEDlwRXXIGdMSq/beltRZLkh7F4YwPrWvYXhRZBfoP32+U=; Received: from [84.212.220.105] (helo=elva) by quimby.gnus.org with esmtpsa (TLS1.3:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.92) (envelope-from ) id 1mUNvm-0006Js-Fh; Sun, 26 Sep 2021 08:46:36 +0200 From: Lars Ingebrigtsen References: <20170116213051.GB4747@acm.fritz.box> X-Now-Playing: Khruangbin's _Late Night Tales: Version Excursions (Selected By Don Letts)_: "=?UTF-8?Q?=E2=80=98Dern_?= =?UTF-8?Q?Kala=E2=80=99?= (Khruangbin Dub Mix)" Date: Sun, 26 Sep 2021 08:46:33 +0200 In-Reply-To: (Stefan Kangas's message of "Sat, 25 Sep 2021 09:12:37 -0700") Message-ID: <87ilynsuk6.fsf@gnus.org> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/28.0.50 (gnu/linux) MIME-Version: 1.0 Content-Type: text/plain X-Spam-Report: Spam detection software, running on the system "quimby.gnus.org", has NOT identified this incoming email as spam. The original message has been attached to this so you can view it or label similar future email. If you have any questions, see @@CONTACT_ADDRESS@@ for details. Content preview: Stefan Kangas writes: > How about adding this at the very end of the ` docstring: > > Note that some macros, such as `pcase', change the meaning of this > symbol. I added Content analysis details: (-2.9 points, 5.0 required) pts rule name description ---- ---------------------- -------------------------------------------------- -1.0 ALL_TRUSTED Passed through trusted hosts only via SMTP -1.9 BAYES_00 BODY: Bayes spam probability is 0 to 1% [score: 0.0000] X-Spam-Score: -2.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 (---) Stefan Kangas writes: > How about adding this at the very end of the ` docstring: > > Note that some macros, such as `pcase', change the meaning of this > symbol. I added Note that some macros, such as `pcase', use this symbol for other purposes. to Emacs 28. -- (domestic pets only, the antidote for overdose, milk.) bloggy blog: http://lars.ingebrigtsen.no From debbugs-submit-bounces@debbugs.gnu.org Sun Sep 26 02:47:27 2021 Received: (at control) by debbugs.gnu.org; 26 Sep 2021 06:47:27 +0000 Received: from localhost ([127.0.0.1]:35591 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1mUNwd-00034O-Ae for submit@debbugs.gnu.org; Sun, 26 Sep 2021 02:47:27 -0400 Received: from quimby.gnus.org ([95.216.78.240]:47810) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1mUNwc-0002zc-5h for control@debbugs.gnu.org; Sun, 26 Sep 2021 02:47:26 -0400 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=gnus.org; s=20200322; h=Subject:From:To:Message-Id:Date:Sender:Reply-To:Cc: MIME-Version:Content-Type:Content-Transfer-Encoding:Content-ID: Content-Description:Resent-Date:Resent-From:Resent-Sender:Resent-To:Resent-Cc :Resent-Message-ID:In-Reply-To:References:List-Id:List-Help:List-Unsubscribe: List-Subscribe:List-Post:List-Owner:List-Archive; bh=TaqnwG6ndk9qTy+D1B09wcjVXZBh5JadEgEWFaBqzvA=; b=PngEyIBLpaQrlLHgep0QiKXNDB P43NgoI37Qao9g6BFFNw4enLzU4n3XxmQC7jrC6Hrts1I11el3LHWILCQ+hb4BRJxt/Gk8+epO1mj 5hoVLL+K/CFMpXUhM0nNpDxlSHV2u/o9zAmPR5/l4xnHBHxZcTTssGQJs6F613A8cekk=; Received: from [84.212.220.105] (helo=elva) by quimby.gnus.org with esmtpsa (TLS1.3:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.92) (envelope-from ) id 1mUNwU-0006KA-Cn for control@debbugs.gnu.org; Sun, 26 Sep 2021 08:47:20 +0200 Date: Sun, 26 Sep 2021 08:47:16 +0200 Message-Id: <87h7e7suiz.fsf@gnus.org> To: control@debbugs.gnu.org From: Lars Ingebrigtsen Subject: control message for bug #25462 X-Spam-Report: Spam detection software, running on the system "quimby.gnus.org", has NOT identified this incoming email as spam. The original message has been attached to this so you can view it or label similar future email. If you have any questions, see @@CONTACT_ADDRESS@@ for details. Content preview: close 25462 28.1 quit Content analysis details: (-2.9 points, 5.0 required) pts rule name description ---- ---------------------- -------------------------------------------------- -1.0 ALL_TRUSTED Passed through trusted hosts only via SMTP -1.9 BAYES_00 BODY: Bayes spam probability is 0 to 1% [score: 0.0000] X-Spam-Score: -2.3 (--) 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: -3.3 (---) close 25462 28.1 quit From unknown Tue Jun 17 01:49:00 2025 X-Loop: help-debbugs@gnu.org Subject: bug#25462: Out of date doc string for "`". Resent-From: Stefan Kangas Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sun, 26 Sep 2021 07:18:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 25462 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: Lars Ingebrigtsen Cc: Alan Mackenzie , 25462@debbugs.gnu.org Received: via spool by 25462-submit@debbugs.gnu.org id=B25462.163264065732056 (code B ref 25462); Sun, 26 Sep 2021 07:18:02 +0000 Received: (at 25462) by debbugs.gnu.org; 26 Sep 2021 07:17:37 +0000 Received: from localhost ([127.0.0.1]:35643 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1mUOPp-0008Kt-D9 for submit@debbugs.gnu.org; Sun, 26 Sep 2021 03:17:37 -0400 Received: from mail-pj1-f46.google.com ([209.85.216.46]:42677) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1mUOPn-0008Ev-Vc for 25462@debbugs.gnu.org; Sun, 26 Sep 2021 03:17:36 -0400 Received: by mail-pj1-f46.google.com with SMTP id rm6-20020a17090b3ec600b0019ece2bdd20so1179747pjb.1 for <25462@debbugs.gnu.org>; Sun, 26 Sep 2021 00:17:35 -0700 (PDT) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=x-gm-message-state:from:in-reply-to:references:mime-version:date :message-id:subject:to:cc; bh=BBzxZbwLotDx9sYXZOs0/l6dfmKGEbuvxsjp1vElsqU=; b=emxPNje8VLLh+tkBxG0u48jff+7vKZr28xf4oH0C2I1zYFfzlbJ+6SOXNSdte/Xl13 8gixiWw5TUy5U5+oWQu0CcObAq05cP4O9wl+B6pxfpmeHrq0L2GU/gfZbyjAzS38Dpjs 12AjvpgLrGegnZpGsBa053m3skguOaEvIvTUtT0nGc65+TUFQ7p0akQmSANeoTJjueeP imJWHanQXFjePg6AcC4rNRI5rcxzz06Ngfwk66qGi1IN9BDrSjF6ddg9UKc6jFOLILFy KbXZ2+V1p8twZqpDwCB1VfWuVmTrHVuc4ACKEWMc7o8Sk+2+9ghsCxGhBzpe+AT/sDIM qxXA== X-Gm-Message-State: AOAM5335Z9ZM12wU0OHoixtz68CE4xewY9xkLEKdkjhTVpjHAhL7hyXJ lPqorpRkneU7tq7Hud0/P3WnKZuYcpKJLAJ+uAQ= X-Google-Smtp-Source: ABdhPJyn7DelfT1/ke3vc0dWLFyLB92dhizT8NYVXhT+/9tkV2ieKyBTgvieoX/NGxLQ7Ti7jwtahpniKa+B10fiLSI= X-Received: by 2002:a17:902:d505:b0:13e:b49:9d8d with SMTP id b5-20020a170902d50500b0013e0b499d8dmr4927267plg.22.1632640650385; Sun, 26 Sep 2021 00:17:30 -0700 (PDT) Received: from 753933720722 named unknown by gmailapi.google.com with HTTPREST; Sun, 26 Sep 2021 00:17:30 -0700 From: Stefan Kangas In-Reply-To: <87ilynsuk6.fsf@gnus.org> References: <20170116213051.GB4747@acm.fritz.box> <87ilynsuk6.fsf@gnus.org> MIME-Version: 1.0 Date: Sun, 26 Sep 2021 00:17:30 -0700 Message-ID: Content-Type: text/plain; charset="UTF-8" X-Spam-Score: 0.5 (/) 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.5 (/) Lars Ingebrigtsen writes: > Stefan Kangas writes: > >> How about adding this at the very end of the ` docstring: >> >> Note that some macros, such as `pcase', change the meaning of this >> symbol. > > I added > > Note that some macros, such as `pcase', use this symbol for other > purposes. > > to Emacs 28. Yes, that's even better. Thanks. From unknown Tue Jun 17 01:49:00 2025 X-Loop: help-debbugs@gnu.org Subject: bug#25462: Out of date doc string for "`". Resent-From: Alan Mackenzie Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sun, 26 Sep 2021 20:32:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 25462 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: Stefan Kangas Cc: Lars Ingebrigtsen , 25462@debbugs.gnu.org Received: via spool by 25462-submit@debbugs.gnu.org id=B25462.163268828929478 (code B ref 25462); Sun, 26 Sep 2021 20:32:02 +0000 Received: (at 25462) by debbugs.gnu.org; 26 Sep 2021 20:31:29 +0000 Received: from localhost ([127.0.0.1]:38817 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1mUao4-0007f8-NT for submit@debbugs.gnu.org; Sun, 26 Sep 2021 16:31:28 -0400 Received: from colin.muc.de ([193.149.48.1]:58596 helo=mail.muc.de) by debbugs.gnu.org with smtp (Exim 4.84_2) (envelope-from ) id 1mUao2-0007XZ-6b for 25462@debbugs.gnu.org; Sun, 26 Sep 2021 16:31:27 -0400 Received: (qmail 44776 invoked by uid 3782); 26 Sep 2021 20:31:18 -0000 Received: from acm.muc.de (p4fe150ab.dip0.t-ipconnect.de [79.225.80.171]) (using STARTTLS) by colin.muc.de (tmda-ofmipd) with ESMTP; Sun, 26 Sep 2021 22:31:18 +0200 Received: (qmail 15936 invoked by uid 1000); 26 Sep 2021 20:31:17 -0000 Date: Sun, 26 Sep 2021 20:31:17 +0000 Message-ID: References: <20170116213051.GB4747@acm.fritz.box> <87ilynsuk6.fsf@gnus.org> MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: X-Submission-Agent: TMDA/1.3.x (Ph3nix) From: Alan Mackenzie X-Primary-Address: acm@muc.de 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: -1.0 (-) Hello, Lars and Stefan. On Sun, Sep 26, 2021 at 00:17:30 -0700, Stefan Kangas wrote: > Lars Ingebrigtsen writes: > > Stefan Kangas writes: > >> How about adding this at the very end of the ` docstring: > >> Note that some macros, such as `pcase', change the meaning of this > >> symbol. > > I added > > Note that some macros, such as `pcase', use this symbol for other > > purposes. > > to Emacs 28. > Yes, that's even better. Thanks. Thanks for the fix! -- Alan Mackenzie (Nuremberg, Germany).