From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED!not-for-mail From: Michael Heerdegen Newsgroups: gmane.emacs.bugs Subject: bug#31311: 27.0; doc of `pcase' Date: Sun, 29 Apr 2018 20:38:01 +0200 Message-ID: <87a7tlluye.fsf@web.de> References: > <83wowqrmp8.fsf@gnu.org>> <9cd18e10-8f14-4a49-a3a4-ed9d50afe860@default> NNTP-Posting-Host: blaine.gmane.org Mime-Version: 1.0 Content-Type: text/plain X-Trace: blaine.gmane.org 1525027036 23729 195.159.176.226 (29 Apr 2018 18:37:16 GMT) X-Complaints-To: usenet@blaine.gmane.org NNTP-Posting-Date: Sun, 29 Apr 2018 18:37:16 +0000 (UTC) User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/27.0.50 (gnu/linux) Cc: 31311@debbugs.gnu.org To: Drew Adams Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Sun Apr 29 20:37:12 2018 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([208.118.235.17]) by blaine.gmane.org with esmtp (Exim 4.84_2) (envelope-from ) id 1fCrC9-00061h-Iz for geb-bug-gnu-emacs@m.gmane.org; Sun, 29 Apr 2018 20:37:09 +0200 Original-Received: from localhost ([::1]:56480 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1fCrEG-0000NO-AI for geb-bug-gnu-emacs@m.gmane.org; Sun, 29 Apr 2018 14:39:20 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:57481) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1fCrE4-00008L-Fr for bug-gnu-emacs@gnu.org; Sun, 29 Apr 2018 14:39:12 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1fCrDy-0004je-TC for bug-gnu-emacs@gnu.org; Sun, 29 Apr 2018 14:39:08 -0400 Original-Received: from debbugs.gnu.org ([208.118.235.43]:35242) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1fCrDy-0004jW-P9 for bug-gnu-emacs@gnu.org; Sun, 29 Apr 2018 14:39:02 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1fCrDy-0001es-FJ for bug-gnu-emacs@gnu.org; Sun, 29 Apr 2018 14:39:02 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Michael Heerdegen Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sun, 29 Apr 2018 18:39:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 31311 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: Original-Received: via spool by 31311-submit@debbugs.gnu.org id=B31311.15250270966320 (code B ref 31311); Sun, 29 Apr 2018 18:39:02 +0000 Original-Received: (at 31311) by debbugs.gnu.org; 29 Apr 2018 18:38:16 +0000 Original-Received: from localhost ([127.0.0.1]:43139 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1fCrDD-0001ds-UX for submit@debbugs.gnu.org; Sun, 29 Apr 2018 14:38:16 -0400 Original-Received: from mout.web.de ([212.227.15.14]:48323) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1fCrDB-0001df-DD for 31311@debbugs.gnu.org; Sun, 29 Apr 2018 14:38:15 -0400 Original-Received: from drachen.dragon ([94.217.119.40]) by smtp.web.de (mrweb002 [213.165.67.108]) with ESMTPSA (Nemesis) id 0MD8VY-1f9aUw2TSG-00GbvN; Sun, 29 Apr 2018 20:38:02 +0200 In-Reply-To: <9cd18e10-8f14-4a49-a3a4-ed9d50afe860@default> (Drew Adams's message of "Sun, 29 Apr 2018 10:02:16 -0700 (PDT)") X-Provags-ID: V03:K1:+YJ41n59AY0qrmqmt2HU/YUYRF3rRX1OiGBmz/xgnPLipYzEQxo 9vhza6gamhlyqQ2178sm1r7plV5kFYc+A4ubpVYiKao6KIt+ogFC2s0axiSYjWuA5ATv4LA YNY0j7wJqgizE904MTbnrnAf/XF2yfb8TVE/XcMX7XjFO7rgBTN/u1DkD3hPsJXjO+Tlxj1 ohM6tx6TacZGOo152pt8A== X-UI-Out-Filterresults: notjunk:1;V01:K0:2Ov7OLEqXIk=:I02ACmKJ4QTWVWo9FJowYb mDvOE/h4w4ukbg1XSfO3RK32y3u4PenOUjivt3LsHZzck/fcKAWLglgPNQiyzcPCKZ4DHq5mO LcX3TvNyrvUDiGimJc9G4r7TpxSKUyEHIBiaaaYbBgfcP276WxEB18iOoqu/VnyivXwIjb4qc Z59EtguxYOrC/C+YeaLYaRHEZeEh4ByZotYFgyVdj7oVgQsmdVzYDcVQpdX4MAlesCw2SHwTk vyutKR3QhZwvEonB8mUnnnadLkCvX+ovFzUUeVuGlryJ0uscPZ0LttMLbwZEBlC8ZY/ZiSUAP zKTBLRguOPeB7APDxCNbwb2Rt3ijN7ljKDwR6em3OjYJkXjgoqg4ah0C7rTB3e/VdUvM+0cYp 0GXroZ3+Wc61GL0pybr71c/EWCNOKy8B5XUu6vXsFyVWEGOEW8ZdNT5V7ThA6DAk4kvXus6jh JeNu0nYomyoYexSkgtYFgeauNxqZXCbwTEWkE74xBZTcn3gpZZoiRGMN75uKbXEXmRT+aekwE kdXd9KBL1MGTvcHMePhyREarFhldxKO7Ca9IARXcKZOQh6xYxvVfWusogak04xtPw/mNIMUjv Pm1N7lAeoAQm3cy8YOHPjbvOFmWFmmf9tX+azo+4b3h/Ix6KqdQ1beJ6MjX/TU01+ya5/ABWS L95brKO0PlRQ/xuVOeh58+ciAClDWAkj4/Shh/TCaU8kne3MiMmYwWP0eAeErji/glGNe172w gHWIBtdzeTR3w3R4hFsyH26AqTNLRIVNlSrnw6w8+haT6nIoheTycjPv7oVARaGc6HgEZOBL X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 208.118.235.43 X-BeenThere: bug-gnu-emacs@gnu.org List-Id: "Bug reports for GNU Emacs, the Swiss army knife of text editors" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Original-Sender: "bug-gnu-emacs" Xref: news.gmane.org gmane.emacs.bugs:145829 Archived-At: Drew Adams writes: > Perhaps you can at least remove the incomprehensible and > seemingly unrelated text (I cited) that appears at the end > of the doc string, as a start. This is not unrelated: These are the docs for additional pcase patterns defined elsewhere: pcase is extensible, and the pattern listing part in the docstring is generated dynamically. As a result of that conception it may not read very fluently as a whole, but it's definitely nothing we want to remove. We clearly have some deficiencies, but the situation IMHO really is not as horrible as Eli's sarcasm suggests. Michael.