From unknown Sun Jun 22 11:43:41 2025 X-Loop: help-debbugs@gnu.org Subject: bug#20759: 25.0.50; pcase doc: (=?UTF-8?Q?=E2=80=98?= QPAT) instead of (` QPAT) Resent-From: Michael Heerdegen Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sun, 07 Jun 2015 15:43:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 20759 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: 20759@debbugs.gnu.org X-Debbugs-Original-To: bug-gnu-emacs@gnu.org Reply-To: michael_heerdegen@web.de Received: via spool by submit@debbugs.gnu.org id=B.143369178016433 (code B ref -1); Sun, 07 Jun 2015 15:43:02 +0000 Received: (at submit) by debbugs.gnu.org; 7 Jun 2015 15:43:00 +0000 Received: from localhost ([127.0.0.1]:44193 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1Z1cix-0004Gy-JT for submit@debbugs.gnu.org; Sun, 07 Jun 2015 11:43:00 -0400 Received: from eggs.gnu.org ([208.118.235.92]:60610) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1Z1civ-0004Gl-4i for submit@debbugs.gnu.org; Sun, 07 Jun 2015 11:42:57 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1Z1cio-0005MA-V3 for submit@debbugs.gnu.org; Sun, 07 Jun 2015 11:42:51 -0400 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,FREEMAIL_FROM autolearn=disabled version=3.3.2 Received: from lists.gnu.org ([2001:4830:134:3::11]:55700) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Z1cio-0005M0-S7 for submit@debbugs.gnu.org; Sun, 07 Jun 2015 11:42:50 -0400 Received: from eggs.gnu.org ([2001:4830:134:3::10]:45879) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Z1cin-0006hw-VK for bug-gnu-emacs@gnu.org; Sun, 07 Jun 2015 11:42:50 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1Z1cie-0005ER-Av for bug-gnu-emacs@gnu.org; Sun, 07 Jun 2015 11:42:49 -0400 Received: from mout.web.de ([212.227.15.4]:59877) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Z1cie-0005DZ-1u for bug-gnu-emacs@gnu.org; Sun, 07 Jun 2015 11:42:40 -0400 Received: from drachen.dragon ([90.187.86.241]) by smtp.web.de (mrweb001) with ESMTPSA (Nemesis) id 0MWAtV-1YZDvg0Jg1-00XKA2 for ; Sun, 07 Jun 2015 17:42:37 +0200 From: Michael Heerdegen Date: Sun, 07 Jun 2015 17:41:47 +0200 Message-ID: <874mmjh6f8.fsf@web.de> MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable X-Provags-ID: V03:K0:OLzcZLWgzYxEmTE2GZB1De8DZHsKRBu9iN+xsldBexopFoNQMX3 J2gh7hACucgr7BLCi1dYcw5gxwdWBK890AORCKejDkuwK0c9AX4E2OhWtcNNNiCex/n3v0s S0vTjE96KLSQCnxbjGu6kBiKU5zfGmf6m8IZmuYLGfWQuR3VZblPpRioBAH3UflpL9gZOzs 7fmnfXc9fNkvynLt5Kg8g== X-UI-Out-Filterresults: notjunk:1;V01:K0:B/BtoCYR7iU=:GI4QZCcxCHxSeshmhzA+3P FH0Eat+/pcumulw6Lk28M+RtsSL9MevQDkwrbVJVjrkSxCbGOA/r1fNmQ/laX2oskhvzNSCKs E0Z5GAxxxerR8pHhME7hpu5d/vkWtFhHJ4iFQyHY9AZruatHlsx3s0IspHcFcpBtRoomWl6As btY7aNxY+7m4EOeB3yUQyWIASN32/o4XPbxdTLymsMqpxwJqbJEbq9GYcRI3MvMoiX+rJNdBM ADB9ujFrbbx2Uae1Upj8EE1VvZvmpIn57Foc4OO39Z1dTVjm5cFdpPOi5uPGqnYlb8BWpl4jr xgA5mI1uKyBtREh3IZ/DGDoPX9EI008L9fM6pkRKlBm5YOWKSiMm31qkxXvZwJW5Ub7IQwLNS YbBkOvZG8ucDfMcH0SCgTz/8tjnP+xEi83H5ZBzhlRFVPuDyvRNqLhR/ywvsqin4YU+xoYd1Z GLTjFzR6MjHallyE+NW26vkgp3gPOJ2m7XOGYGhoVvoGNFNgVjTA8SKNy9F6+OZiCmt5+sBs1 kDoBFdPUN8cJ75/MsVeqKk+9/TfngusA+TCDVbnsLQfvwTJw/HkmyQW8oCpaKgnnqS6i7cVGn pFQt4a6Lk0p2WnXb/Az6tw88VOVbRI2E6ikL7KBJ7hR0MIPRlD7sb2E48BmLcqhpu3BPFCzdR u3Ck+O+Rn51aEMJTnFQX4wXud5cLX4QQlPDrdkN0E1Zc7c4yqGPstRnYdcIr4dOZZLg8= X-detected-operating-system: by eggs.gnu.org: GNU/Linux 3.x [generic] X-detected-operating-system: by eggs.gnu.org: Error: Malformed IPv6 address (bad octet value). X-Received-From: 2001:4830:134:3::11 X-Spam-Score: -4.1 (----) 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: -4.1 (----) Hello, probably related to the recent changes to the type of quotation used in documentation: M-: (require 'pcase) RET C-h f pcase RET prints as last paragraph: -- (=E2=80=98 QPAT) =20=20 Backquote-style pcase patterns. [...] The backquote in the pattern description has been replaced by a curved quote, which is wrong. Thanks, Michael. In GNU Emacs 25.0.50.3 (x86_64-unknown-linux-gnu, GTK+ Version 3.14.5) of 2015-06-07 on drachen Windowing system distributor `The X.Org Foundation', version 11.0.11701000 System Description: Debian GNU/Linux testing (stretch) Configured features: XPM JPEG TIFF GIF PNG RSVG IMAGEMAGICK SOUND DBUS GSETTINGS NOTIFY LIBXML2 FREETYPE XFT ZLIB TOOLKIT_SCROLL_BARS GTK3 From unknown Sun Jun 22 11:43:41 2025 X-Loop: help-debbugs@gnu.org Subject: bug#20759: 25.0.50; pcase doc: (=?UTF-8?Q?=E2=80=98?= QPAT) instead of (` QPAT) Resent-From: Glenn Morris Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sun, 07 Jun 2015 18:15:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 20759 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: michael_heerdegen@web.de Cc: 20759@debbugs.gnu.org Received: via spool by 20759-submit@debbugs.gnu.org id=B20759.14337008955066 (code B ref 20759); Sun, 07 Jun 2015 18:15:02 +0000 Received: (at 20759) by debbugs.gnu.org; 7 Jun 2015 18:14:55 +0000 Received: from localhost ([127.0.0.1]:44273 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1Z1f5z-0001Je-B6 for submit@debbugs.gnu.org; Sun, 07 Jun 2015 14:14:55 -0400 Received: from eggs.gnu.org ([208.118.235.92]:34625) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1Z1f5x-0001JQ-AF for 20759@debbugs.gnu.org; Sun, 07 Jun 2015 14:14:53 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1Z1f5r-0004hD-6g for 20759@debbugs.gnu.org; Sun, 07 Jun 2015 14:14:47 -0400 X-Spam-Checker-Version: SpamAssassin 3.3.2 (2011-06-06) on eggs.gnu.org X-Spam-Level: X-Spam-Status: No, score=-1.9 required=5.0 tests=BAYES_00,T_RP_MATCHES_RCVD autolearn=disabled version=3.3.2 Received: from fencepost.gnu.org ([2001:4830:134:3::e]:37817) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Z1f5n-0004g0-KM; Sun, 07 Jun 2015 14:14:43 -0400 Received: from rgm by fencepost.gnu.org with local (Exim 4.82) (envelope-from ) id 1Z1f5n-0006iT-6I; Sun, 07 Jun 2015 14:14:43 -0400 From: Glenn Morris References: <874mmjh6f8.fsf@web.de> X-Spook: Palestine Liberation Front dictionary Tamil Tigers Meth X-Ran: $d3m`.a5wm}!c=DYo6U^c3'j0pg|etPgJdq^#5D%;d(}--{7(afsC_7ca\7Fu!Y4jV5+yE X-Hue: green X-Attribution: GM Date: Sun, 07 Jun 2015 14:14:43 -0400 In-Reply-To: <874mmjh6f8.fsf@web.de> (Michael Heerdegen's message of "Sun, 07 Jun 2015 17:41:47 +0200") Message-ID: User-Agent: Gnus (www.gnus.org), GNU Emacs (www.gnu.org/software/emacs/) MIME-Version: 1.0 Content-Type: text/plain X-detected-operating-system: by eggs.gnu.org: Error: Malformed IPv6 address (bad octet value). X-Received-From: 2001:4830:134:3::e X-Spam-Score: -5.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: -5.0 (-----) Michael Heerdegen wrote: > The backquote in the pattern description has been replaced by a curved > quote, which is wrong. Please feel free to just fix it. TIA. From unknown Sun Jun 22 11:43:41 2025 X-Loop: help-debbugs@gnu.org Subject: bug#20759: 25.0.50; pcase doc: (=?UTF-8?Q?=E2=80=98?= QPAT) instead of (` QPAT) Resent-From: Glenn Morris Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sun, 07 Jun 2015 18:19:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 20759 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: michael_heerdegen@web.de Cc: 20759@debbugs.gnu.org Received: via spool by 20759-submit@debbugs.gnu.org id=B20759.143370111711084 (code B ref 20759); Sun, 07 Jun 2015 18:19:02 +0000 Received: (at 20759) by debbugs.gnu.org; 7 Jun 2015 18:18:37 +0000 Received: from localhost ([127.0.0.1]:44277 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1Z1f9Y-0002sh-Br for submit@debbugs.gnu.org; Sun, 07 Jun 2015 14:18:36 -0400 Received: from eggs.gnu.org ([208.118.235.92]:35039) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1Z1f9V-0002sS-Vw for 20759@debbugs.gnu.org; Sun, 07 Jun 2015 14:18:34 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1Z1f9O-0006Dl-3T for 20759@debbugs.gnu.org; Sun, 07 Jun 2015 14:18:28 -0400 X-Spam-Checker-Version: SpamAssassin 3.3.2 (2011-06-06) on eggs.gnu.org X-Spam-Level: X-Spam-Status: No, score=-1.9 required=5.0 tests=BAYES_00,T_RP_MATCHES_RCVD autolearn=disabled version=3.3.2 Received: from fencepost.gnu.org ([2001:4830:134:3::e]:37836) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Z1f9L-0006D7-8b; Sun, 07 Jun 2015 14:18:23 -0400 Received: from rgm by fencepost.gnu.org with local (Exim 4.82) (envelope-from ) id 1Z1f9K-0006xY-So; Sun, 07 Jun 2015 14:18:22 -0400 From: Glenn Morris References: <874mmjh6f8.fsf@web.de> X-Spook: Department of Homeland Security JFK AGT. AMME WMATA X-Ran: vPERi-XH34Smmf(0j[ (Glenn Morris's message of "Sun, 07 Jun 2015 14:14:43 -0400") Message-ID: <4p8ubvjsb5.fsf@fencepost.gnu.org> User-Agent: Gnus (www.gnus.org), GNU Emacs (www.gnu.org/software/emacs/) MIME-Version: 1.0 Content-Type: text/plain X-detected-operating-system: by eggs.gnu.org: Error: Malformed IPv6 address (bad octet value). X-Received-From: 2001:4830:134:3::e X-Spam-Score: -5.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: -5.0 (-----) Glenn Morris wrote: > Michael Heerdegen wrote: > >> The backquote in the pattern description has been replaced by a curved >> quote, which is wrong. > > Please feel free to just fix it. TIA. Oh, it seems to be some generated thing. I assumed it was just a typo. From unknown Sun Jun 22 11:43:41 2025 X-Loop: help-debbugs@gnu.org Subject: bug#20759: 25.0.50; pcase doc: (=?UTF-8?Q?=E2=80=98?= QPAT) instead of (` QPAT) Resent-From: Michael Heerdegen Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sun, 07 Jun 2015 18:42:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 20759 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: Glenn Morris Cc: 20759@debbugs.gnu.org Received: via spool by 20759-submit@debbugs.gnu.org id=B20759.143370249918870 (code B ref 20759); Sun, 07 Jun 2015 18:42:01 +0000 Received: (at 20759) by debbugs.gnu.org; 7 Jun 2015 18:41:39 +0000 Received: from localhost ([127.0.0.1]:44299 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1Z1fVq-0004uI-PD for submit@debbugs.gnu.org; Sun, 07 Jun 2015 14:41:39 -0400 Received: from mout.web.de ([212.227.17.11]:58782) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1Z1fVo-0004u3-BX for 20759@debbugs.gnu.org; Sun, 07 Jun 2015 14:41:37 -0400 Received: from drachen.dragon ([90.187.86.241]) by smtp.web.de (mrweb103) with ESMTPSA (Nemesis) id 0Lb25F-1ZURtJ17Iv-00kgo6; Sun, 07 Jun 2015 20:41:28 +0200 From: Michael Heerdegen References: <874mmjh6f8.fsf@web.de> <4p8ubvjsb5.fsf@fencepost.gnu.org> Date: Sun, 07 Jun 2015 20:41:22 +0200 In-Reply-To: <4p8ubvjsb5.fsf@fencepost.gnu.org> (Glenn Morris's message of "Sun, 07 Jun 2015 14:18:22 -0400") Message-ID: <87vbezfjjh.fsf@web.de> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/25.0.50 (gnu/linux) MIME-Version: 1.0 Content-Type: text/plain X-Provags-ID: V03:K0:GXHi0ecj3djRhmCa7/09Lch2ALe2GxZDKubHq/eIQwFlCquMjgG TPlEn+H9vcnAmj3gc2TSCSIjKDMuWJ6MzQSfuAVEowyWZ3Ak3ra2ry+jeyUQA6U0swdPIsw 3jpOJsFDXiEPvAOT9SNO7S6qNMkeMo7xLGriq8iLuJ3O1bBxGHUyt7y2i3/TWGBYRIbQSlG hnQGKIx2xkAwzXOGMccsA== X-UI-Out-Filterresults: notjunk:1; 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 (/) Glenn Morris writes: > Oh, it seems to be some generated thing. I assumed it was just a typo. The generated doc was correct until some days or so. So I guess it's related to the recent changes switching to the new quoting style. Michael. From unknown Sun Jun 22 11:43:41 2025 MIME-Version: 1.0 X-Mailer: MIME-tools 5.503 (Entity 5.503) X-Loop: help-debbugs@gnu.org From: help-debbugs@gnu.org (GNU bug Tracking System) To: michael_heerdegen@web.de Subject: bug#20759: closed (Re: bug#20759: 25.0.50; pcase doc: (=?UTF-8?Q?=E2=80=98?= QPAT) instead of (` QPAT)) Message-ID: References: <5574AC9A.1000606@yandex.ru> <874mmjh6f8.fsf@web.de> X-Gnu-PR-Message: they-closed 20759 X-Gnu-PR-Package: emacs Reply-To: 20759@debbugs.gnu.org Date: Sun, 07 Jun 2015 20:43:03 +0000 Content-Type: multipart/mixed; boundary="----------=_1433709783-2666-1" This is a multi-part message in MIME format... ------------=_1433709783-2666-1 Content-Disposition: inline Content-Transfer-Encoding: quoted-printable Content-Type: text/plain; charset="utf-8" Your bug report #20759: 25.0.50; pcase doc: (=E2=80=98 QPAT) instead of (` QPAT) which was filed against the emacs package, has been closed. The explanation is attached below, along with your original report. If you require more details, please reply to 20759@debbugs.gnu.org. --=20 20759: http://debbugs.gnu.org/cgi/bugreport.cgi?bug=3D20759 GNU Bug Tracking System Contact help-debbugs@gnu.org with problems ------------=_1433709783-2666-1 Content-Type: message/rfc822 Content-Disposition: inline Content-Transfer-Encoding: 7bit Received: (at 20759-done) by debbugs.gnu.org; 7 Jun 2015 20:42:14 +0000 Received: from localhost ([127.0.0.1]:44349 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1Z1hOY-0000fz-1R for submit@debbugs.gnu.org; Sun, 07 Jun 2015 16:42:14 -0400 Received: from mail-wi0-f169.google.com ([209.85.212.169]:32849) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1Z1hOV-0000fU-Te for 20759-done@debbugs.gnu.org; Sun, 07 Jun 2015 16:42:12 -0400 Received: by wiwd19 with SMTP id d19so66813037wiw.0 for <20759-done@debbugs.gnu.org>; Sun, 07 Jun 2015 13:42:06 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=sender:subject:to:references:from:message-id:date:user-agent :mime-version:in-reply-to:content-type:content-transfer-encoding; bh=tLjik+r0gzZjKkU15oJEgt9skf7hXfCY2xvlkhelgt0=; b=ksEGYw1PwZ0DIPqrCo1PLWYrAeZSFO2KbGZLG6wOkt4gY3Ez7x6YGaInltKsDi76Fo zzBvEOgKfYeRGZX7usy/2FERaTWVmzIF2xwHeSGiEfR5kH25Q0WWDNwcu7CuWMwxXng2 E6JaCP4P8xSonUeG2RuY/wmVZ1jYW0oEbFjBN7WAe1tmcuE1PDg9BRjIjWx0unnturAe IJyuaHEz9i3psG/68PShqjCx659usQa8CNgj6i7cNAJHxoYB2Lt1iC5MDoVV/bnngys4 /oyeAejFftFJY5ScIgmg6MRmXuXn68J0O0sbGlMoWCmw+crMsifnBtRXhU+wRPLsHc1F eowQ== X-Received: by 10.180.11.174 with SMTP id r14mr15834664wib.72.1433709726327; Sun, 07 Jun 2015 13:42:06 -0700 (PDT) Received: from [192.168.1.2] ([82.102.93.54]) by mx.google.com with ESMTPSA id m10sm5089052wib.17.2015.06.07.13.42.05 (version=TLSv1.2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128); Sun, 07 Jun 2015 13:42:06 -0700 (PDT) Subject: =?UTF-8?Q?Re:_bug#20759:_25.0.50; _pcase_doc:_=28=e2=80=98_QPAT=29_i?= =?UTF-8?Q?nstead_of_=28`_QPAT=29?= To: michael_heerdegen@web.de, 20759-done@debbugs.gnu.org References: <874mmjh6f8.fsf@web.de> From: Dmitry Gutov Message-ID: <5574AC9A.1000606@yandex.ru> Date: Sun, 7 Jun 2015 23:42:02 +0300 User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:38.0) Gecko/20100101 Thunderbird/38.0 MIME-Version: 1.0 In-Reply-To: <874mmjh6f8.fsf@web.de> Content-Type: text/plain; charset=utf-8; format=flowed Content-Transfer-Encoding: 7bit X-Spam-Score: -0.7 (/) X-Debbugs-Envelope-To: 20759-done 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.7 (/) On 06/07/2015 06:41 PM, Michael Heerdegen wrote: > The backquote in the pattern description has been replaced by a curved > quote, which is wrong. Should be fixed now. ------------=_1433709783-2666-1 Content-Type: message/rfc822 Content-Disposition: inline Content-Transfer-Encoding: 7bit Received: (at submit) by debbugs.gnu.org; 7 Jun 2015 15:43:00 +0000 Received: from localhost ([127.0.0.1]:44193 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1Z1cix-0004Gy-JT for submit@debbugs.gnu.org; Sun, 07 Jun 2015 11:43:00 -0400 Received: from eggs.gnu.org ([208.118.235.92]:60610) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1Z1civ-0004Gl-4i for submit@debbugs.gnu.org; Sun, 07 Jun 2015 11:42:57 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1Z1cio-0005MA-V3 for submit@debbugs.gnu.org; Sun, 07 Jun 2015 11:42:51 -0400 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,FREEMAIL_FROM autolearn=disabled version=3.3.2 Received: from lists.gnu.org ([2001:4830:134:3::11]:55700) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Z1cio-0005M0-S7 for submit@debbugs.gnu.org; Sun, 07 Jun 2015 11:42:50 -0400 Received: from eggs.gnu.org ([2001:4830:134:3::10]:45879) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Z1cin-0006hw-VK for bug-gnu-emacs@gnu.org; Sun, 07 Jun 2015 11:42:50 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1Z1cie-0005ER-Av for bug-gnu-emacs@gnu.org; Sun, 07 Jun 2015 11:42:49 -0400 Received: from mout.web.de ([212.227.15.4]:59877) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Z1cie-0005DZ-1u for bug-gnu-emacs@gnu.org; Sun, 07 Jun 2015 11:42:40 -0400 Received: from drachen.dragon ([90.187.86.241]) by smtp.web.de (mrweb001) with ESMTPSA (Nemesis) id 0MWAtV-1YZDvg0Jg1-00XKA2 for ; Sun, 07 Jun 2015 17:42:37 +0200 From: Michael Heerdegen To: bug-gnu-emacs@gnu.org Subject: 25.0.50; pcase doc: =?utf-8?Q?=28=E2=80=98?= QPAT) instead of (` QPAT) Date: Sun, 07 Jun 2015 17:41:47 +0200 Message-ID: <874mmjh6f8.fsf@web.de> MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable X-Provags-ID: V03:K0:OLzcZLWgzYxEmTE2GZB1De8DZHsKRBu9iN+xsldBexopFoNQMX3 J2gh7hACucgr7BLCi1dYcw5gxwdWBK890AORCKejDkuwK0c9AX4E2OhWtcNNNiCex/n3v0s S0vTjE96KLSQCnxbjGu6kBiKU5zfGmf6m8IZmuYLGfWQuR3VZblPpRioBAH3UflpL9gZOzs 7fmnfXc9fNkvynLt5Kg8g== X-UI-Out-Filterresults: notjunk:1;V01:K0:B/BtoCYR7iU=:GI4QZCcxCHxSeshmhzA+3P FH0Eat+/pcumulw6Lk28M+RtsSL9MevQDkwrbVJVjrkSxCbGOA/r1fNmQ/laX2oskhvzNSCKs E0Z5GAxxxerR8pHhME7hpu5d/vkWtFhHJ4iFQyHY9AZruatHlsx3s0IspHcFcpBtRoomWl6As btY7aNxY+7m4EOeB3yUQyWIASN32/o4XPbxdTLymsMqpxwJqbJEbq9GYcRI3MvMoiX+rJNdBM ADB9ujFrbbx2Uae1Upj8EE1VvZvmpIn57Foc4OO39Z1dTVjm5cFdpPOi5uPGqnYlb8BWpl4jr xgA5mI1uKyBtREh3IZ/DGDoPX9EI008L9fM6pkRKlBm5YOWKSiMm31qkxXvZwJW5Ub7IQwLNS YbBkOvZG8ucDfMcH0SCgTz/8tjnP+xEi83H5ZBzhlRFVPuDyvRNqLhR/ywvsqin4YU+xoYd1Z GLTjFzR6MjHallyE+NW26vkgp3gPOJ2m7XOGYGhoVvoGNFNgVjTA8SKNy9F6+OZiCmt5+sBs1 kDoBFdPUN8cJ75/MsVeqKk+9/TfngusA+TCDVbnsLQfvwTJw/HkmyQW8oCpaKgnnqS6i7cVGn pFQt4a6Lk0p2WnXb/Az6tw88VOVbRI2E6ikL7KBJ7hR0MIPRlD7sb2E48BmLcqhpu3BPFCzdR u3Ck+O+Rn51aEMJTnFQX4wXud5cLX4QQlPDrdkN0E1Zc7c4yqGPstRnYdcIr4dOZZLg8= X-detected-operating-system: by eggs.gnu.org: GNU/Linux 3.x [generic] X-detected-operating-system: by eggs.gnu.org: Error: Malformed IPv6 address (bad octet value). X-Received-From: 2001:4830:134:3::11 X-Spam-Score: -4.1 (----) X-Debbugs-Envelope-To: submit X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.15 Precedence: list Reply-To: michael_heerdegen@web.de 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.1 (----) Hello, probably related to the recent changes to the type of quotation used in documentation: M-: (require 'pcase) RET C-h f pcase RET prints as last paragraph: -- (=E2=80=98 QPAT) =20=20 Backquote-style pcase patterns. [...] The backquote in the pattern description has been replaced by a curved quote, which is wrong. Thanks, Michael. In GNU Emacs 25.0.50.3 (x86_64-unknown-linux-gnu, GTK+ Version 3.14.5) of 2015-06-07 on drachen Windowing system distributor `The X.Org Foundation', version 11.0.11701000 System Description: Debian GNU/Linux testing (stretch) Configured features: XPM JPEG TIFF GIF PNG RSVG IMAGEMAGICK SOUND DBUS GSETTINGS NOTIFY LIBXML2 FREETYPE XFT ZLIB TOOLKIT_SCROLL_BARS GTK3 ------------=_1433709783-2666-1-- From unknown Sun Jun 22 11:43:41 2025 X-Loop: help-debbugs@gnu.org Subject: bug#20759: 25.0.50; pcase doc: (=?UTF-8?Q?=E2=80=98?= QPAT) instead of (` QPAT) References: <874mmjh6f8.fsf@web.de> In-Reply-To: <874mmjh6f8.fsf@web.de> Resent-From: Paul Eggert Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Thu, 11 Jun 2015 17:38:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 20759 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: 20759@debbugs.gnu.org Cc: michael_heerdegen@web.de, Glenn Morris , Dmitry Gutov Received: via spool by 20759-submit@debbugs.gnu.org id=B20759.14340442745259 (code B ref 20759); Thu, 11 Jun 2015 17:38:01 +0000 Received: (at 20759) by debbugs.gnu.org; 11 Jun 2015 17:37:54 +0000 Received: from localhost ([127.0.0.1]:50994 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1Z36QK-0001Mi-IQ for submit@debbugs.gnu.org; Thu, 11 Jun 2015 13:37:54 -0400 Received: from zimbra.cs.ucla.edu ([131.179.128.68]:45432) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1Z36QI-0001MU-0a for 20759@debbugs.gnu.org; Thu, 11 Jun 2015 13:37:51 -0400 Received: from localhost (localhost [127.0.0.1]) by zimbra.cs.ucla.edu (Postfix) with ESMTP id 576BF1604F5; Thu, 11 Jun 2015 10:37:44 -0700 (PDT) Received: from zimbra.cs.ucla.edu ([127.0.0.1]) by localhost (zimbra.cs.ucla.edu [127.0.0.1]) (amavisd-new, port 10032) with ESMTP id UhZ9sF_P4G4q; Thu, 11 Jun 2015 10:37:42 -0700 (PDT) Received: from localhost (localhost [127.0.0.1]) by zimbra.cs.ucla.edu (Postfix) with ESMTP id 92B4016075E; Thu, 11 Jun 2015 10:37:42 -0700 (PDT) X-Virus-Scanned: amavisd-new at zimbra.cs.ucla.edu Received: from zimbra.cs.ucla.edu ([127.0.0.1]) by localhost (zimbra.cs.ucla.edu [127.0.0.1]) (amavisd-new, port 10026) with ESMTP id 1bXQ0VCQ6cf7; Thu, 11 Jun 2015 10:37:42 -0700 (PDT) Received: from Penguin.CS.UCLA.EDU (Penguin.CS.UCLA.EDU [131.179.64.200]) by zimbra.cs.ucla.edu (Postfix) with ESMTPSA id 6F54B16074B; Thu, 11 Jun 2015 10:37:42 -0700 (PDT) Message-ID: <5579C761.1070505@cs.ucla.edu> Date: Thu, 11 Jun 2015 10:37:37 -0700 From: Paul Eggert Organization: UCLA Computer Science Department User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:31.0) Gecko/20100101 Thunderbird/31.7.0 MIME-Version: 1.0 Content-Type: multipart/mixed; boundary="------------020105090300010206070908" 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 (/) This is a multi-part message in MIME format. --------------020105090300010206070908 Content-Type: text/plain; charset=utf-8; format=flowed Content-Transfer-Encoding: quoted-printable That bug was a symptom of a more general confusion between raw=20 docstrings and formatted docstrings, which I attempted to fix in commit=20 b2205626370071bc85dc07b043c833bc50c0baec with the attached patch. As the patch mentions, I'm puzzled about the syntax =E2=80=98(` PAT)=E2=80= =99 in the=20 docstring, since lread.c says that syntax is obsolete and =E2=80=98format= =E2=80=99=20 quotes the grave accent. The attached patch causes C-h f to suggest the=20 syntax =E2=80=98(\` PAT)=E2=80=99 which is "safer" in some sense, I suppo= se. If it's=20 intended that pcase usage omit the backslash, then I guess that =E2=80=98= format=E2=80=99=20 and/or lread.c need to be updated accordingly. --------------020105090300010206070908 Content-Type: text/x-patch; name="0001-Fix-quoting-of-help-for-functions-with-odd-names.patch" Content-Disposition: attachment; filename*0="0001-Fix-quoting-of-help-for-functions-with-odd-names.patch" Content-Transfer-Encoding: quoted-printable >From df62898b1b606f73afa0686b54eca345b1234f3d Mon Sep 17 00:00:00 2001 From: Paul Eggert Date: Thu, 11 Jun 2015 10:23:46 -0700 Subject: [PATCH] Fix quoting of help for functions with odd names While investigating Bug#20759, I discovered other quoting problems: C-h f mishandled characters like backslash and quote in function names. This fix changes the behavior so that 'C-h f pcase RET' now generates "... (\` QPAT) ..." instead of "... (` QPAT) ...", because '(format "%S" '(` FOO))' returns "(\\` FOO)". A comment in src/lread.c's read1 function says that the backslash will be needed starting in Emacs 25, which implies that 'format' is correct and the old pcase documention was wrong to omit the backslash. * lisp/emacs-lisp/nadvice.el (advice--make-docstring): * lisp/help-fns.el (help-fns--signature): * lisp/help.el (help-add-fundoc-usage): * lisp/progmodes/elisp-mode.el (elisp-function-argstring): Use help--make-usage-docstring rather than formatting help-make-usage. * lisp/emacs-lisp/pcase.el (pcase--make-docstring): Return raw docstring. * lisp/help-fns.el (help-fns--signature): New arg RAW, to return raw docstring. Take more care to distinguish raw from cooked dstrings. (describe-function-1): Let help-fns--signature substitute command keys. * lisp/help.el (help--docstring-quote): New function. (help-split-fundoc): Use it, to quote funny characters more systematically. (help--make-usage): Rename from help-make-usage, since this should be private. Leave an obsolete alias for the old name. (help--make-usage-docstring): New function. * test/automated/help-fns.el (help-fns-test-funny-names): New test. --- lisp/emacs-lisp/nadvice.el | 2 +- lisp/emacs-lisp/pcase.el | 6 ++--- lisp/help-fns.el | 53 +++++++++++++++++++++++---------------= ------ lisp/help.el | 31 +++++++++++++++++++------- lisp/progmodes/elisp-mode.el | 2 +- test/automated/help-fns.el | 23 +++++++++++++++++++ 6 files changed, 79 insertions(+), 38 deletions(-) diff --git a/lisp/emacs-lisp/nadvice.el b/lisp/emacs-lisp/nadvice.el index faebe26..a6db5e9 100644 --- a/lisp/emacs-lisp/nadvice.el +++ b/lisp/emacs-lisp/nadvice.el @@ -114,7 +114,7 @@ Each element has the form (WHERE BYTECODE STACK) wher= e: (usage (help-split-fundoc origdoc function))) (setq usage (if (null usage) (let ((arglist (help-function-arglist flist))) - (format "%S" (help-make-usage function arglist))= ) + (help--make-usage-docstring function arglist)) (setq origdoc (cdr usage)) (car usage))) (help-add-fundoc-usage (concat docstring origdoc) usage)))) =20 diff --git a/lisp/emacs-lisp/pcase.el b/lisp/emacs-lisp/pcase.el index ab82b7e..0d3b21b 100644 --- a/lisp/emacs-lisp/pcase.el +++ b/lisp/emacs-lisp/pcase.el @@ -163,7 +163,7 @@ Currently, the following patterns are provided this w= ay:" expansion)))) =20 (declare-function help-fns--signature "help-fns" - (function doc real-def real-function)) + (function doc real-def real-function raw)) =20 ;; FIXME: Obviously, this will collide with nadvice's use of ;; function-documentation if we happen to advise `pcase'. @@ -183,7 +183,7 @@ Currently, the following patterns are provided this w= ay:" (insert "\n\n-- ") (let* ((doc (documentation me 'raw))) (setq doc (help-fns--signature symbol doc me - (indirect-function me))) + (indirect-function me) t)) (insert "\n" (or doc "Not documented."))))))) (let ((combined-doc (buffer-string))) (if ud (help-add-fundoc-usage combined-doc (car ud)) combined-do= c))))) @@ -870,7 +870,7 @@ QPAT can take the following forms: (QPAT1 . QPAT2) matches if QPAT1 matches the car and QPAT2 the c= dr. [QPAT1 QPAT2..QPATn] matches a vector of length n and QPAT1..QPATn ma= tch its 0..(n-1)th elements, respectively. - ,PAT matches if the pattern PAT matches. + ,PAT matches if the pattern PAT matches. STRING matches if the object is `equal' to STRING. ATOM matches if the object is `eq' to ATOM." (declare (debug (pcase-QPAT))) diff --git a/lisp/help-fns.el b/lisp/help-fns.el index d59eeab..931e8af 100644 --- a/lisp/help-fns.el +++ b/lisp/help-fns.el @@ -353,7 +353,7 @@ suitable file is found, return nil." (help-xref-button 1 'help-function-cmacro function lib))))= ) (insert ".\n")))) =20 -(defun help-fns--signature (function doc real-def real-function) +(defun help-fns--signature (function doc real-def real-function raw) "Insert usage at point and return docstring. With highlighting." (if (keymapp function) doc ; If definition is a keymap, skip arglis= t note. @@ -365,7 +365,7 @@ suitable file is found, return nil." (let* ((use (cond ((and usage (not (listp advertised))) (car usage)) ((listp arglist) - (format "%S" (help-make-usage function arglist))) + (help--make-usage-docstring function arglist)) ((stringp arglist) arglist) ;; Maybe the arglist is in the docstring of a symbol ;; this one is aliased to. @@ -379,16 +379,20 @@ suitable file is found, return nil." (car usage)) ((or (stringp real-def) (vectorp real-def)) - (format "\nMacro: %s" (format-kbd-macro real-def))) + (format "\nMacro: %s" + (help--docstring-quote + (format-kbd-macro real-def)))) (t "[Missing arglist. Please make a bug report.]"))) - (high (help-highlight-arguments - ;; Quote any quotes in the function name (bug#20759)= . - (replace-regexp-in-string "\\(\\)[`']" "\\=3D" use t= t 1) - doc))) - (let ((fill-begin (point))) - (insert (car high) "\n") - (fill-region fill-begin (point))) - (cdr high))))) + (high (if raw + (cons use doc) + (help-highlight-arguments (substitute-command-keys = use) + (substitute-command-keys = doc))))) + (let ((fill-begin (point)) + (high-usage (car high)) + (high-doc (cdr high))) + (insert high-usage "\n") + (fill-region fill-begin (point)) + high-doc))))) =20 (defun help-fns--parent-mode (function) ;; If this is a derived mode, link to the parent. @@ -579,23 +583,22 @@ FILE is the file where FUNCTION was probably define= d." (point))) (terpri)(terpri) =20 - (let* ((doc-raw (documentation function t)) - ;; If the function is autoloaded, and its docstring has - ;; key substitution constructs, load the library. - (doc (progn - (and (autoloadp real-def) doc-raw - help-enable-auto-load - (string-match "\\([^\\]=3D\\|[^=3D]\\|\\`\\)\\\\[[{<]" - doc-raw) - (autoload-do-load real-def)) - (substitute-command-keys doc-raw)))) + (let ((doc-raw (documentation function t))) + + ;; If the function is autoloaded, and its docstring has + ;; key substitution constructs, load the library. + (and (autoloadp real-def) doc-raw + help-enable-auto-load + (string-match "\\([^\\]=3D\\|[^=3D]\\|\\`\\)\\\\[[{<]" doc-raw) + (autoload-do-load real-def)) =20 (help-fns--key-bindings function) (with-current-buffer standard-output - (setq doc (help-fns--signature function doc sig-key real-funct= ion)) - (run-hook-with-args 'help-fns-describe-function-functions function) - (insert "\n" - (or doc "Not documented."))))))) + (let ((doc (help-fns--signature function doc-raw sig-key + real-function nil))) + (run-hook-with-args 'help-fns-describe-function-functions function) + (insert "\n" + (or doc "Not documented.")))))))) =20 ;; Add defaults to `help-fns-describe-function-functions'. (add-hook 'help-fns-describe-function-functions #'help-fns--obsolete) diff --git a/lisp/help.el b/lisp/help.el index fd5cbc6..b766cd0 100644 --- a/lisp/help.el +++ b/lisp/help.el @@ -1349,6 +1349,11 @@ the help window if the current value of the user o= ption (princ msg))))) =20 =0C +(defun help--docstring-quote (string) + "Return a doc string that represents STRING. +The result, when formatted by =E2=80=98substitute-command-keys=E2=80=99,= should equal STRING." + (replace-regexp-in-string "['\\`]" "\\\\=3D\\&" string)) + ;; The following functions used to be in help-fns.el, which is not prelo= aded. ;; But for various reasons, they are more widely needed, so they were ;; moved to this file, which is preloaded. http://debbugs.gnu.org/17001 @@ -1364,12 +1369,17 @@ DEF is the function whose usage we're looking for= in DOCSTRING." ;; function's name in the doc string so we use `fn' as the anonymous ;; function name instead. (when (and docstring (string-match "\n\n(fn\\(\\( .*\\)?)\\)\\'" docst= ring)) - (cons (format "(%s%s" - ;; Replace `fn' with the actual function name. - (if (symbolp def) def "anonymous") - (match-string 1 docstring)) - (unless (zerop (match-beginning 0)) - (substring docstring 0 (match-beginning 0)))))) + (let ((doc (unless (zerop (match-beginning 0)) + (substring docstring 0 (match-beginning 0)))) + (usage-tail (match-string 1 docstring))) + (cons (format "(%s%s" + ;; Replace `fn' with the actual function name. + (if (symbolp def) + (help--docstring-quote + (substring (format "%S" (list def)) 1 -1)) + 'anonymous) + usage-tail) + doc)))) =20 (defun help-add-fundoc-usage (docstring arglist) "Add the usage info to DOCSTRING. @@ -1387,7 +1397,7 @@ ARGLIST can also be t or a string of the form \"(FU= N ARG1 ARG2 ...)\"." (if (and (stringp arglist) (string-match "\\`([^ ]+\\(.*\\))\\'" arglist)) (concat "(fn" (match-string 1 arglist) ")") - (format "%S" (help-make-usage 'fn arglist)))))) + (help--make-usage-docstring 'fn arglist))))) =20 (defun help-function-arglist (def &optional preserve-names) "Return a formal argument list for the function DEF. @@ -1442,7 +1452,7 @@ the same names as used in the original source code,= when possible." "[Arg list not available until function definition is loaded.]") (t t))) =20 -(defun help-make-usage (function arglist) +(defun help--make-usage (function arglist) (cons (if (symbolp function) function 'anonymous) (mapcar (lambda (arg) (if (not (symbolp arg)) arg @@ -1454,6 +1464,11 @@ the same names as used in the original source code= , when possible." (t (intern (upcase name))))))) arglist))) =20 +(define-obsolete-function-alias 'help-make-usage 'help--make-usage "25.1= ") + +(defun help--make-usage-docstring (fn arglist) + (help--docstring-quote (format "%S" (help--make-usage fn arglist)))) + =0C (provide 'help) =20 diff --git a/lisp/progmodes/elisp-mode.el b/lisp/progmodes/elisp-mode.el index 5d5f258..11c9b16 100644 --- a/lisp/progmodes/elisp-mode.el +++ b/lisp/progmodes/elisp-mode.el @@ -1436,7 +1436,7 @@ In the absence of INDEX, just call `eldoc-docstring= -format-sym-doc'." ARGLIST is either a string, or a list of strings or symbols." (let ((str (cond ((stringp arglist) arglist) ((not (listp arglist)) nil) - (t (format "%S" (help-make-usage 'toto arglist)))))) + (t (help--make-usage-docstring 'toto arglist))))) (if (and str (string-match "\\`([^ )]+ ?" str)) (replace-match "(" t t str) str))) diff --git a/test/automated/help-fns.el b/test/automated/help-fns.el index ba87593..4815ac6 100644 --- a/test/automated/help-fns.el +++ b/test/automated/help-fns.el @@ -34,4 +34,27 @@ (goto-char (point-min)) (should (search-forward "autoloaded Lisp macro" (line-end-position))= ))) =20 +(defun abc\\\[universal-argument\]b\`c\'d\\e\"f (x) + "A function with a funny name. + +\(fn XYYZZY)" + x) + +(defun defgh\\\[universal-argument\]b\`c\'d\\e\"f (x) + "Another function with a funny name." + x) + +(ert-deftest help-fns-test-funny-names () + "Test for help with functions with funny names." + (describe-function 'abc\\\[universal-argument\]b\`c\'d\\e\"f) + (with-current-buffer "*Help*" + (goto-char (point-min)) + (should (search-forward + "(abc\\\\\\[universal-argument\\]b\\`c\\'d\\\\e\\\"f XYYZZY= )"))) + (describe-function 'defgh\\\[universal-argument\]b\`c\'d\\e\"f) + (with-current-buffer "*Help*" + (goto-char (point-min)) + (should (search-forward + "(defgh\\\\\\[universal-argument\\]b\\`c\\'d\\\\e\\\"f X)")= ))) + ;;; help-fns.el ends here --=20 2.1.0 --------------020105090300010206070908-- From unknown Sun Jun 22 11:43:41 2025 X-Loop: help-debbugs@gnu.org Subject: bug#20759: 25.0.50; pcase doc: (=?UTF-8?Q?=E2=80=98?= QPAT) instead of (` QPAT) Resent-From: Michael Heerdegen Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Fri, 12 Jun 2015 12:21:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 20759 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: Paul Eggert Cc: 20759@debbugs.gnu.org, Dmitry Gutov Received: via spool by 20759-submit@debbugs.gnu.org id=B20759.143411165329784 (code B ref 20759); Fri, 12 Jun 2015 12:21:02 +0000 Received: (at 20759) by debbugs.gnu.org; 12 Jun 2015 12:20:53 +0000 Received: from localhost ([127.0.0.1]:51352 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1Z3Nx5-0007kH-IV for submit@debbugs.gnu.org; Fri, 12 Jun 2015 08:20:52 -0400 Received: from mout.web.de ([212.227.15.3]:60320) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1Z3Nx2-0007k2-95 for 20759@debbugs.gnu.org; Fri, 12 Jun 2015 08:20:49 -0400 Received: from drachen.dragon ([90.187.252.31]) by smtp.web.de (mrweb003) with ESMTPSA (Nemesis) id 0M6mQO-1ZHUU91Xca-00wSru; Fri, 12 Jun 2015 14:20:41 +0200 From: Michael Heerdegen References: <874mmjh6f8.fsf@web.de> <5579C761.1070505@cs.ucla.edu> Date: Fri, 12 Jun 2015 14:20:35 +0200 In-Reply-To: <5579C761.1070505@cs.ucla.edu> (Paul Eggert's message of "Thu, 11 Jun 2015 10:37:37 -0700") Message-ID: <87eglh6ru4.fsf@web.de> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/25.0.50 (gnu/linux) MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable X-Provags-ID: V03:K0:FM2gFm1jLbM4y8lhSHmXt9tcI0rXxk4lo0WSbLAOE9hW5LLZr0r Rn3VW1RQZPdzHSJb183ejG/nIb7poJdubUqJL+yZdpagjZOnsC7Hbdfxl7mzOQBUl7e6rNX +C2rUEgip+edWaFrcMhRKdhBlKSy0ATI9u7IC4QUaS/puidUc4tEzsWCiywZ1NjtivgJFw2 77I4UN3LpxGAWKESeEaVg== X-UI-Out-Filterresults: notjunk:1; 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 (/) Paul Eggert writes: > As the patch mentions, I'm puzzled about the syntax =E2=80=98(` PAT)=E2= =80=99 in the > docstring, since lread.c says that syntax is obsolete and =E2=80=98format= =E2=80=99 > quotes the grave accent. The attached patch causes C-h f to suggest > the syntax =E2=80=98(\` PAT)=E2=80=99 which is "safer" in some sense, I s= uppose. If > it's intended that pcase usage omit the backslash, then I guess that > =E2=80=98format=E2=80=99 and/or lread.c need to be updated accordingly. Thanks for working on that. Thinking again about this, maybe `PAT would be didactically better, in this special case of the pcase doc. People not being aware of backquote being a reader macro should not think (pcase '(1 2) ((\` (1 2)) t)) is the "correct" way to use this (instead of (pcase '(1 2) (`(1 2) t)) ). I know that the doc of pcase is generated automatically, and your (Paul's) patch makes this more consistent. OTOH, we write 'VAL and not (\' VAL) some lines above in the same documentation. Regards, Michael. From unknown Sun Jun 22 11:43:41 2025 X-Loop: help-debbugs@gnu.org Subject: bug#20759: 25.0.50; pcase doc: (=?UTF-8?Q?=E2=80=98?= QPAT) instead of (` QPAT) Resent-From: Stefan Monnier Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Fri, 12 Jun 2015 14:07:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 20759 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: Michael Heerdegen Cc: 20759@debbugs.gnu.org, Paul Eggert , Dmitry Gutov Received: via spool by 20759-submit@debbugs.gnu.org id=B20759.14341179718533 (code B ref 20759); Fri, 12 Jun 2015 14:07:01 +0000 Received: (at 20759) by debbugs.gnu.org; 12 Jun 2015 14:06:11 +0000 Received: from localhost ([127.0.0.1]:51916 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1Z3Pb1-0002DZ-7X for submit@debbugs.gnu.org; Fri, 12 Jun 2015 10:06:11 -0400 Received: from mercure.iro.umontreal.ca ([132.204.24.67]:43162) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1Z3Pay-0002DP-1T for 20759@debbugs.gnu.org; Fri, 12 Jun 2015 10:06:08 -0400 Received: from hidalgo.iro.umontreal.ca (hidalgo.iro.umontreal.ca [132.204.27.50]) by mercure.iro.umontreal.ca (Postfix) with ESMTP id 4E9999C14A; Fri, 12 Jun 2015 10:06:07 -0400 (EDT) Received: from lechon.iro.umontreal.ca (lechon.iro.umontreal.ca [132.204.27.242]) by hidalgo.iro.umontreal.ca (Postfix) with ESMTP id 3A01D1E5B99; Fri, 12 Jun 2015 10:05:41 -0400 (EDT) Received: by lechon.iro.umontreal.ca (Postfix, from userid 20848) id 04CD8B416C; Fri, 12 Jun 2015 10:05:40 -0400 (EDT) From: Stefan Monnier Message-ID: References: <874mmjh6f8.fsf@web.de> <5579C761.1070505@cs.ucla.edu> <87eglh6ru4.fsf@web.de> Date: Fri, 12 Jun 2015 10:05:40 -0400 In-Reply-To: <87eglh6ru4.fsf@web.de> (Michael Heerdegen's message of "Fri, 12 Jun 2015 14:20:35 +0200") User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/25.0.50 (gnu/linux) MIME-Version: 1.0 Content-Type: text/plain X-DIRO-MailScanner-Information: Please contact the ISP for more information X-DIRO-MailScanner: Found to be clean X-DIRO-MailScanner-SpamCheck: n'est pas un polluriel, SpamAssassin (score=-2.82, requis 5, autolearn=not spam, ALL_TRUSTED -2.82, MC_TSTLAST 0.00) X-DIRO-MailScanner-From: monnier@iro.umontreal.ca X-Spam-Status: No X-Spam-Score: -2.3 (--) 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: -2.3 (--) > Thinking again about this, maybe `PAT would be didactically better, in Indeed. Stefan From unknown Sun Jun 22 11:43:41 2025 X-Loop: help-debbugs@gnu.org Subject: bug#20759: 25.0.50; pcase doc: (=?UTF-8?Q?=E2=80=98?= QPAT) instead of (` QPAT) Resent-From: Paul Eggert Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Fri, 12 Jun 2015 23:35:03 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 20759 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: Michael Heerdegen Cc: 20759@debbugs.gnu.org, Dmitry Gutov Received: via spool by 20759-submit@debbugs.gnu.org id=B20759.14341520625278 (code B ref 20759); Fri, 12 Jun 2015 23:35:03 +0000 Received: (at 20759) by debbugs.gnu.org; 12 Jun 2015 23:34:22 +0000 Received: from localhost ([127.0.0.1]:52165 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1Z3YSr-0001N4-QB for submit@debbugs.gnu.org; Fri, 12 Jun 2015 19:34:22 -0400 Received: from zimbra.cs.ucla.edu ([131.179.128.68]:52739) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1Z3YSp-0001Ml-Oe for 20759@debbugs.gnu.org; Fri, 12 Jun 2015 19:34:20 -0400 Received: from localhost (localhost [127.0.0.1]) by zimbra.cs.ucla.edu (Postfix) with ESMTP id 9308B1607BA; Fri, 12 Jun 2015 16:34:13 -0700 (PDT) Received: from zimbra.cs.ucla.edu ([127.0.0.1]) by localhost (zimbra.cs.ucla.edu [127.0.0.1]) (amavisd-new, port 10032) with ESMTP id kz7Ag7gmdgPt; Fri, 12 Jun 2015 16:34:12 -0700 (PDT) Received: from localhost (localhost [127.0.0.1]) by zimbra.cs.ucla.edu (Postfix) with ESMTP id 8F2D61607BB; Fri, 12 Jun 2015 16:34:12 -0700 (PDT) X-Virus-Scanned: amavisd-new at zimbra.cs.ucla.edu Received: from zimbra.cs.ucla.edu ([127.0.0.1]) by localhost (zimbra.cs.ucla.edu [127.0.0.1]) (amavisd-new, port 10026) with ESMTP id mpPBu_PYK-63; Fri, 12 Jun 2015 16:34:12 -0700 (PDT) Received: from Penguin.CS.UCLA.EDU (Penguin.CS.UCLA.EDU [131.179.64.200]) by zimbra.cs.ucla.edu (Postfix) with ESMTPSA id 726A01607BA; Fri, 12 Jun 2015 16:34:12 -0700 (PDT) Message-ID: <557B6C71.8070507@cs.ucla.edu> Date: Fri, 12 Jun 2015 16:34:09 -0700 From: Paul Eggert Organization: UCLA Computer Science Department User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:31.0) Gecko/20100101 Thunderbird/31.7.0 MIME-Version: 1.0 References: <874mmjh6f8.fsf@web.de> <5579C761.1070505@cs.ucla.edu> <87eglh6ru4.fsf@web.de> In-Reply-To: <87eglh6ru4.fsf@web.de> Content-Type: multipart/mixed; boundary="------------080006060502090501000807" 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 (/) This is a multi-part message in MIME format. --------------080006060502090501000807 Content-Type: text/plain; charset=utf-8; format=flowed Content-Transfer-Encoding: 7bit On 06/12/2015 05:20 AM, Michael Heerdegen wrote: > Thinking again about this, maybe `PAT would be didactically better, in > this special case of the pcase doc. Sure, that's doable. For consistency, the usage string computed automatically by "C-h f `" should be "`STRUCTURE", not "(\` STRUCTURE)". I installed the attached. --------------080006060502090501000807 Content-Type: text/x-patch; name="0001-Document-X-as-X-not-as-X.patch" Content-Transfer-Encoding: 7bit Content-Disposition: attachment; filename="0001-Document-X-as-X-not-as-X.patch" >From 8f79b74f37e6787d27b69cac14091ec25b03a89e Mon Sep 17 00:00:00 2001 From: Paul Eggert Date: Fri, 12 Jun 2015 16:27:42 -0700 Subject: [PATCH] Document `X as "`X", not as "(` X)" * lisp/help.el (help-split-fundoc, help--make-usage-docstring): Document (backquote FOO) as "`FOO", not as "(` FOO)" (Bug#20759). --- lisp/help.el | 29 +++++++++++++++++------------ 1 file changed, 17 insertions(+), 12 deletions(-) diff --git a/lisp/help.el b/lisp/help.el index b766cd0..d24fbfd 100644 --- a/lisp/help.el +++ b/lisp/help.el @@ -1368,18 +1368,21 @@ DEF is the function whose usage we're looking for in DOCSTRING." ;; In cases where `function' has been fset to a subr we can't search for ;; function's name in the doc string so we use `fn' as the anonymous ;; function name instead. - (when (and docstring (string-match "\n\n(fn\\(\\( .*\\)?)\\)\\'" docstring)) + (when (and docstring + (string-match "\n\n(fn\\(\\( +\\([^\n ]+\\( .*\\)?\\)?\\)?)\\)\\'" + docstring)) (let ((doc (unless (zerop (match-beginning 0)) - (substring docstring 0 (match-beginning 0)))) - (usage-tail (match-string 1 docstring))) - (cons (format "(%s%s" - ;; Replace `fn' with the actual function name. - (if (symbolp def) - (help--docstring-quote - (substring (format "%S" (list def)) 1 -1)) - 'anonymous) - usage-tail) - doc)))) + (substring docstring 0 (match-beginning 0))))) + (cons (if (and (eq def '\`) (match-beginning 3) (not (match-beginning 4))) + (concat "\\=`" (match-string 3 docstring)) + (let ((usage-tail (match-string 1 docstring))) + (format "(%s%s" + ;; Replace `fn' with the actual function name. + (if (symbolp def) + (help--docstring-quote (format "%S" def)) + 'anonymous) + usage-tail))) + doc)))) (defun help-add-fundoc-usage (docstring arglist) "Add the usage info to DOCSTRING. @@ -1467,7 +1470,9 @@ the same names as used in the original source code, when possible." (define-obsolete-function-alias 'help-make-usage 'help--make-usage "25.1") (defun help--make-usage-docstring (fn arglist) - (help--docstring-quote (format "%S" (help--make-usage fn arglist)))) + (help--docstring-quote + (let ((print-quoted (eq fn '\`))) + (format "%S" (help--make-usage fn arglist))))) (provide 'help) -- 2.1.0 --------------080006060502090501000807-- From unknown Sun Jun 22 11:43:41 2025 X-Loop: help-debbugs@gnu.org Subject: bug#20759: 25.0.50; pcase doc: (=?UTF-8?Q?=E2=80=98?= QPAT) instead of (` QPAT) Resent-From: Stefan Monnier Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sat, 13 Jun 2015 14:13:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 20759 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: Paul Eggert Cc: Michael Heerdegen , 20759@debbugs.gnu.org, Dmitry Gutov Received: via spool by 20759-submit@debbugs.gnu.org id=B20759.143420477320573 (code B ref 20759); Sat, 13 Jun 2015 14:13:01 +0000 Received: (at 20759) by debbugs.gnu.org; 13 Jun 2015 14:12:53 +0000 Received: from localhost ([127.0.0.1]:52789 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1Z3mB3-0005Ll-JF for submit@debbugs.gnu.org; Sat, 13 Jun 2015 10:12:53 -0400 Received: from chene.dit.umontreal.ca ([132.204.246.20]:59809) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1Z3mB1-0005Ld-6Q for 20759@debbugs.gnu.org; Sat, 13 Jun 2015 10:12:52 -0400 Received: from fmsmemgm.homelinux.net (lechon.iro.umontreal.ca [132.204.27.242]) by chene.dit.umontreal.ca (8.14.1/8.14.1) with ESMTP id t5DECdaY014621; Sat, 13 Jun 2015 10:12:39 -0400 Received: by fmsmemgm.homelinux.net (Postfix, from userid 20848) id 78898AE0CA; Sat, 13 Jun 2015 10:12:39 -0400 (EDT) From: Stefan Monnier Message-ID: References: <874mmjh6f8.fsf@web.de> <5579C761.1070505@cs.ucla.edu> <87eglh6ru4.fsf@web.de> <557B6C71.8070507@cs.ucla.edu> Date: Sat, 13 Jun 2015 10:12:39 -0400 In-Reply-To: <557B6C71.8070507@cs.ucla.edu> (Paul Eggert's message of "Fri, 12 Jun 2015 16:34:09 -0700") User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/25.0.50 (gnu/linux) MIME-Version: 1.0 Content-Type: text/plain X-NAI-Spam-Flag: NO X-NAI-Spam-Threshold: 5 X-NAI-Spam-Score: 0 X-NAI-Spam-Rules: 1 Rules triggered RV5336=0 X-NAI-Spam-Version: 2.3.0.9393 : core <5336> : inlines <3192> : streams <1454779> : uri <1957957> X-Spam-Score: -1.3 (-) 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: -1.3 (-) > * lisp/help.el (help-split-fundoc, help--make-usage-docstring): > Document (backquote FOO) as "`FOO", not as "(` FOO)" (Bug#20759). Since the result of help-split-fundoc is also sometimes fed back to help-add-fundoc-usage, help-add-fundoc-usage would need to be updated correspondingly. So, maybe a better approach is to do this in help-fns--signature. Stefan From unknown Sun Jun 22 11:43:41 2025 X-Loop: help-debbugs@gnu.org Subject: bug#20759: 25.0.50; pcase doc: (=?UTF-8?Q?=E2=80=98?= QPAT) instead of (` QPAT) Resent-From: Paul Eggert Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sat, 13 Jun 2015 16:37:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 20759 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: Stefan Monnier Cc: Michael Heerdegen , 20759@debbugs.gnu.org, Dmitry Gutov Received: via spool by 20759-submit@debbugs.gnu.org id=B20759.143421340213263 (code B ref 20759); Sat, 13 Jun 2015 16:37:01 +0000 Received: (at 20759) by debbugs.gnu.org; 13 Jun 2015 16:36:42 +0000 Received: from localhost ([127.0.0.1]:52882 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1Z3oQE-0003Rr-AB for submit@debbugs.gnu.org; Sat, 13 Jun 2015 12:36:42 -0400 Received: from zimbra.cs.ucla.edu ([131.179.128.68]:38278) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1Z3oQB-0003Rb-TS for 20759@debbugs.gnu.org; Sat, 13 Jun 2015 12:36:40 -0400 Received: from localhost (localhost [127.0.0.1]) by zimbra.cs.ucla.edu (Postfix) with ESMTP id 4E64216080F; Sat, 13 Jun 2015 09:36:34 -0700 (PDT) Received: from zimbra.cs.ucla.edu ([127.0.0.1]) by localhost (zimbra.cs.ucla.edu [127.0.0.1]) (amavisd-new, port 10032) with ESMTP id 6GhETQcSr8qF; Sat, 13 Jun 2015 09:36:33 -0700 (PDT) Received: from localhost (localhost [127.0.0.1]) by zimbra.cs.ucla.edu (Postfix) with ESMTP id A10A516080A; Sat, 13 Jun 2015 09:36:33 -0700 (PDT) X-Virus-Scanned: amavisd-new at zimbra.cs.ucla.edu Received: from zimbra.cs.ucla.edu ([127.0.0.1]) by localhost (zimbra.cs.ucla.edu [127.0.0.1]) (amavisd-new, port 10026) with ESMTP id JmmVSeAQz4jF; Sat, 13 Jun 2015 09:36:33 -0700 (PDT) Received: from [192.168.1.9] (pool-100-32-155-148.lsanca.fios.verizon.net [100.32.155.148]) by zimbra.cs.ucla.edu (Postfix) with ESMTPSA id 75078160806; Sat, 13 Jun 2015 09:36:33 -0700 (PDT) Message-ID: <557C5C11.9090703@cs.ucla.edu> Date: Sat, 13 Jun 2015 09:36:33 -0700 From: Paul Eggert Organization: UCLA Computer Science Department User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:31.0) Gecko/20100101 Thunderbird/31.7.0 MIME-Version: 1.0 References: <874mmjh6f8.fsf@web.de> <5579C761.1070505@cs.ucla.edu> <87eglh6ru4.fsf@web.de> <557B6C71.8070507@cs.ucla.edu> In-Reply-To: Content-Type: text/plain; charset=utf-8; format=flowed Content-Transfer-Encoding: 7bit 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 (/) Stefan Monnier wrote: > maybe a better approach is to do this in help-fns--signature. Thanks, that does sound better. I installed a patch along those lines as commit 8afef016e2bc413c7a4913554ea6ed2c55474de6.