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:31:59 +0200 Message-ID: <87efixlv8g.fsf@web.de> References: <83wowqrmp8.fsf@gnu.org> NNTP-Posting-Host: blaine.gmane.org Mime-Version: 1.0 Content-Type: text/plain X-Trace: blaine.gmane.org 1525026666 30264 195.159.176.226 (29 Apr 2018 18:31:06 GMT) X-Complaints-To: usenet@blaine.gmane.org NNTP-Posting-Date: Sun, 29 Apr 2018 18:31:06 +0000 (UTC) User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/27.0.50 (gnu/linux) Cc: 31311@debbugs.gnu.org To: Eli Zaretskii Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Sun Apr 29 20:31:02 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 1fCr6D-0007kL-V2 for geb-bug-gnu-emacs@m.gmane.org; Sun, 29 Apr 2018 20:31:02 +0200 Original-Received: from localhost ([::1]:56468 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1fCr8K-0007Ud-PH for geb-bug-gnu-emacs@m.gmane.org; Sun, 29 Apr 2018 14:33:12 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:56475) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1fCr8E-0007UN-2P for bug-gnu-emacs@gnu.org; Sun, 29 Apr 2018 14:33:06 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1fCr8A-0002Xi-VE for bug-gnu-emacs@gnu.org; Sun, 29 Apr 2018 14:33:06 -0400 Original-Received: from debbugs.gnu.org ([208.118.235.43]:35238) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1fCr8A-0002Xe-Ri for bug-gnu-emacs@gnu.org; Sun, 29 Apr 2018 14:33:02 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1fCr8A-0001WY-DN for bug-gnu-emacs@gnu.org; Sun, 29 Apr 2018 14:33: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:33: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.15250267345799 (code B ref 31311); Sun, 29 Apr 2018 18:33:02 +0000 Original-Received: (at 31311) by debbugs.gnu.org; 29 Apr 2018 18:32:14 +0000 Original-Received: from localhost ([127.0.0.1]:43135 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1fCr7O-0001VT-92 for submit@debbugs.gnu.org; Sun, 29 Apr 2018 14:32:14 -0400 Original-Received: from mout.web.de ([212.227.17.12]:36963) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1fCr7M-0001VF-0q for 31311@debbugs.gnu.org; Sun, 29 Apr 2018 14:32:12 -0400 Original-Received: from drachen.dragon ([94.217.119.40]) by smtp.web.de (mrweb103 [213.165.67.124]) with ESMTPSA (Nemesis) id 0M3T5g-1eMGUj0Rge-00r00H; Sun, 29 Apr 2018 20:32:01 +0200 In-Reply-To: <83wowqrmp8.fsf@gnu.org> (Eli Zaretskii's message of "Sun, 29 Apr 2018 19:39:47 +0300") X-Provags-ID: V03:K1:X2eVyCqDTQzQ454hJlFlPcMQvvl33cv3H0z6v5XxMPZz1uwamL4 0taBhoTuj5TDpVq9iT+CYXbQsAKs1rbRq4CbIracqXhxFOX1aacWyYYqSO2NLu7Yu1yNYSe lDvHQQJ26QbW/tZJnJS0efN2W6M07CT3Jn6kLoUghmgsVAGop5XQ50cFGHjy2OWYvbcwa86 tb/k1jfBydu8t0l9GJ3sg== X-UI-Out-Filterresults: notjunk:1;V01:K0:+9xO1i7ERpc=:Zgnf+zEdp7vNbmZIeizS/p hrdzfbUswp0hlU4jU3UtY3Myia9vJfQtDz3xKnjVUrxvJz0i+5y+AKTEbJB9Two5Z+AYKp3rC GtVveWF1mYwJs3LbGqMfgOxVYL4LKLy3Cckvx91gvQiulBRcheayalevqtxRs3capvFC0tYtp 58GN5KayrCT4+qs22PWkar+PWBVvxtmF7Lo+AfwUye5DCJijC9sEoLTUwkKtu/Uo2oVdg14+4 Rr42zoQrYloa5lQIj4lVJjIJsYPYrsBBqhDCKYGoqguLv9HhaSkJ1aPatBmclJtyNMhWaoRjd S4Z4Xg8UEcCt+B6rIq+ljCVJ4Z0X9y9xxicj7VSEDcCFO3KiskqjbqnhacLLIxa57vQ5aIZAc izhCldvkMNJcex/uv6GLqLzVlBir7/8rsvgCIiXQ54sbqd8r+1HYepRtfQ9l49b+Ksycyx6p0 X2Arez/xW4QvDK7QWX41ecZztuztuNmE5SngRsvGN0MkxtBl127stby3sIBCi288LQ5AAS1bo DvTyxvFhQi3784t4zV721EYtgRDNNAHSNRdjYmZ34RaWMwPw6cN/pChxr5mnqKMQnj9XS+BAG 7DSu2psLKuyQN22EyPc1c7n2OBBFUJskuvOJKyOb9KyTHa1ReIFZARn39kOPGgi23RE08FM0a GTOYygax/UXjqA8qtd/S3sAmOYGm5BJKlRWCbKFcStqZQ+jZeWOZUzmJNQNBjYWFa9zAtSMVx P8aUFEhtQAqAnVfSmJuqWbp739zEA84igRKFjG1FIbwLyKIIWv6VK4YdCAOT4f4g1ONDxtxZ 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:145828 Archived-At: Eli Zaretskii writes: > It seems that no one really cares to document this facility. Maybe > 'pcase' is seen as a kind of test: if you succeed in using and > understanding it without any clear documentation, you are admitted to > certain quarters where only wizards can enter. > > What you see in the manual is mostly the result of desperate efforts > of a single individual to have something remotely palatable in our > documentation. My impression was more that there were diametral conceptions of how a good documentation would look like. And there _has_ been some improvements of the original (sparse) docs, I now find the docstring of the macro itself quite good (and complete). The texts in the manual are not so good for otoh, I agree. Michael.