From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED!not-for-mail From: Eli Zaretskii Newsgroups: gmane.emacs.bugs Subject: bug#31311: 27.0; doc of `pcase' Date: Mon, 30 Apr 2018 05:36:32 +0300 Message-ID: <83k1sps9n3.fsf@gnu.org> References: <83wowqrmp8.fsf@gnu.org> <87efixlv8g.fsf@web.de> <83muxlsvfm.fsf@gnu.org> <871sexlqvw.fsf@web.de> Reply-To: Eli Zaretskii NNTP-Posting-Host: blaine.gmane.org X-Trace: blaine.gmane.org 1525055706 12970 195.159.176.226 (30 Apr 2018 02:35:06 GMT) X-Complaints-To: usenet@blaine.gmane.org NNTP-Posting-Date: Mon, 30 Apr 2018 02:35:06 +0000 (UTC) Cc: 31311@debbugs.gnu.org To: Michael Heerdegen Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Mon Apr 30 04:35: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 1fCyeb-0003Hn-MS for geb-bug-gnu-emacs@m.gmane.org; Mon, 30 Apr 2018 04:35:01 +0200 Original-Received: from localhost ([::1]:57548 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1fCygi-0000y3-Nl for geb-bug-gnu-emacs@m.gmane.org; Sun, 29 Apr 2018 22:37:12 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:46426) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1fCygY-0000xn-Qt for bug-gnu-emacs@gnu.org; Sun, 29 Apr 2018 22:37:03 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1fCygX-0001Qr-Tu for bug-gnu-emacs@gnu.org; Sun, 29 Apr 2018 22:37:02 -0400 Original-Received: from debbugs.gnu.org ([208.118.235.43]:35419) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1fCygX-0001Qh-Q2 for bug-gnu-emacs@gnu.org; Sun, 29 Apr 2018 22:37:01 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1fCygX-0000Fg-Jp for bug-gnu-emacs@gnu.org; Sun, 29 Apr 2018 22:37:01 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Eli Zaretskii Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Mon, 30 Apr 2018 02:37:01 +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.1525055816957 (code B ref 31311); Mon, 30 Apr 2018 02:37:01 +0000 Original-Received: (at 31311) by debbugs.gnu.org; 30 Apr 2018 02:36:56 +0000 Original-Received: from localhost ([127.0.0.1]:43316 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1fCygR-0000FN-Mi for submit@debbugs.gnu.org; Sun, 29 Apr 2018 22:36:55 -0400 Original-Received: from eggs.gnu.org ([208.118.235.92]:55410) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1fCygP-0000F9-MD for 31311@debbugs.gnu.org; Sun, 29 Apr 2018 22:36:54 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1fCygH-0001DC-IM for 31311@debbugs.gnu.org; Sun, 29 Apr 2018 22:36:48 -0400 Original-Received: from fencepost.gnu.org ([2001:4830:134:3::e]:53025) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1fCygH-0001D6-F8; Sun, 29 Apr 2018 22:36:45 -0400 Original-Received: from [176.228.60.248] (port=4103 helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:RSA_AES_256_CBC_SHA1:256) (Exim 4.82) (envelope-from ) id 1fCygG-00078v-Kn; Sun, 29 Apr 2018 22:36:45 -0400 In-reply-to: <871sexlqvw.fsf@web.de> (message from Michael Heerdegen on Sun, 29 Apr 2018 22:05:55 +0200) X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] 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:145851 Archived-At: > From: Michael Heerdegen > Cc: drew.adams@oracle.com, 31311@debbugs.gnu.org > Date: Sun, 29 Apr 2018 22:05:55 +0200 > > Eli Zaretskii writes: > > > There's nothing special about this feature that should present > > conceptual problems for documenting it well, any more than any other > > advanced feature of which we have dozens in the ELisp manual. > > >From the beginning people were divided about the usefulness and > conception of the thing, and people discussed exceptionally emotionally > and destructively. Irrelevant. We are talking about documentation, not about the feature itself. The concept of how such complex features should be documented is well established in Emacs, and we have a wealth of examples in the ELisp manual of how it should be and is done.