From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED!not-for-mail From: Noam Postavsky Newsgroups: gmane.emacs.bugs Subject: bug#31311: 27.0; doc of `pcase' Date: Mon, 30 Apr 2018 07:20:23 -0400 Message-ID: <87wowpndoo.fsf@gmail.com> References: <83wowqrmp8.fsf@gnu.org> <87efixlv8g.fsf@web.de> <83muxlsvfm.fsf@gnu.org> <871sexlqvw.fsf@web.de> <83k1sps9n3.fsf@gnu.org> NNTP-Posting-Host: blaine.gmane.org Mime-Version: 1.0 Content-Type: text/plain X-Trace: blaine.gmane.org 1525087147 23497 195.159.176.226 (30 Apr 2018 11:19:07 GMT) X-Complaints-To: usenet@blaine.gmane.org NNTP-Posting-Date: Mon, 30 Apr 2018 11:19:07 +0000 (UTC) User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/26.1 (gnu/linux) Cc: Michael Heerdegen , 31311@debbugs.gnu.org To: Eli Zaretskii Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Mon Apr 30 13:19:03 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 1fD6pi-0005wT-2B for geb-bug-gnu-emacs@m.gmane.org; Mon, 30 Apr 2018 13:19:02 +0200 Original-Received: from localhost ([::1]:59097 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1fD6ro-0000IO-CV for geb-bug-gnu-emacs@m.gmane.org; Mon, 30 Apr 2018 07:21:12 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:34347) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1fD6rh-0000II-RV for bug-gnu-emacs@gnu.org; Mon, 30 Apr 2018 07:21:06 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1fD6re-0008IP-MW for bug-gnu-emacs@gnu.org; Mon, 30 Apr 2018 07:21:05 -0400 Original-Received: from debbugs.gnu.org ([208.118.235.43]:35576) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1fD6re-0008IJ-I4 for bug-gnu-emacs@gnu.org; Mon, 30 Apr 2018 07:21:02 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1fD6rd-0006Ds-Rc for bug-gnu-emacs@gnu.org; Mon, 30 Apr 2018 07:21:02 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Noam Postavsky Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Mon, 30 Apr 2018 11:21: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.152508723323863 (code B ref 31311); Mon, 30 Apr 2018 11:21:01 +0000 Original-Received: (at 31311) by debbugs.gnu.org; 30 Apr 2018 11:20:33 +0000 Original-Received: from localhost ([127.0.0.1]:43473 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1fD6rA-0006Co-TU for submit@debbugs.gnu.org; Mon, 30 Apr 2018 07:20:33 -0400 Original-Received: from mail-qk0-f170.google.com ([209.85.220.170]:42383) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1fD6r8-0006CY-M1 for 31311@debbugs.gnu.org; Mon, 30 Apr 2018 07:20:31 -0400 Original-Received: by mail-qk0-f170.google.com with SMTP id j10so6313141qke.9 for <31311@debbugs.gnu.org>; Mon, 30 Apr 2018 04:20:30 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=from:to:cc:subject:references:date:in-reply-to:message-id :user-agent:mime-version; bh=AcJwWxJptg7eugOpy/mIVWBi8BpZidstuWZoCDk4pP8=; b=X1njyQfNmsB3m2ZLq4Z3xTVN73anNY8RnJ3C78c0hzpsR3Fjf3maUoBryPYmSIZoiE p8iKvyy3pSJyZeao5hqNLXxqu8MEqwCAYyCX30ON7q5bjlWmPwZtm4VOHlmMR5VVRGGG uHHxkA7eDkEkTj9kIJgbXPsNsTZ2IxqseE1zSKQZslPqF6vyXQ6R7DfELXO9Se1DZ9C8 iQlcaieUnJxK1+EK0sV5SiD9oT8HDnd9gxPy+jU1vxQaPqSsDVethwrGdTCODlj1AGMD YIRxrpMUxG0Z/vVq8QeSJmb8n9KARl2Xow9yJiyZHiHCaimUUqsRfjjmd9AVL5hPsBSF WEsw== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:from:to:cc:subject:references:date:in-reply-to :message-id:user-agent:mime-version; bh=AcJwWxJptg7eugOpy/mIVWBi8BpZidstuWZoCDk4pP8=; b=kfPYufgHOn9ccVcTXGnG0fnsvoXotZoZBCuZ4CT/rqqacHFa31nkyUPo8gYYXRZ2b2 MdTVdTfMArLsHxwmGrWcHqyv2X5tmJLOKYUAuUN9cVyRrUqtfrJsk2iPiIw7DWdZDbC3 YCnANBcouLiksugksETK4f1MyXRC3QQkKbLbTLFV8D8LFijuScnzAWzMR7s3dIonuwBQ bWiEge7PP3G1HG7JuW8U8L0P2H+1+eTU7RuSBpYJy04q9s16a8FTmdd6kyR7bAHjdwwW mD6Hl7ChwkjaxF7r79S7wKmxyU1QvRNApAvFmobNJa3XoZ2VjPS2xgdswI1rFGCE7O6Y dwyQ== X-Gm-Message-State: ALQs6tDIVdmalyCRxoQ8Dmlfn1V1zuerbgVV1FXuY9bPO8/629HMMBhK HWr6GRm5xAFjNl6bN0zmVlY= X-Google-Smtp-Source: AB8JxZqke2hiILx4fgbKZqO8l+3om9IzodLDtLddHziADUeZNzM20olBWtQGTcPFU7l0WhjTVsDUNg== X-Received: by 10.55.26.41 with SMTP id a41mr9854647qka.401.1525087225181; Mon, 30 Apr 2018 04:20:25 -0700 (PDT) Original-Received: from zebian (cbl-45-2-119-34.yyz.frontiernetworks.ca. [45.2.119.34]) by smtp.googlemail.com with ESMTPSA id i99sm500751qkh.35.2018.04.30.04.20.23 (version=TLS1_2 cipher=ECDHE-RSA-CHACHA20-POLY1305 bits=256/256); Mon, 30 Apr 2018 04:20:24 -0700 (PDT) In-Reply-To: <83k1sps9n3.fsf@gnu.org> (Eli Zaretskii's message of "Mon, 30 Apr 2018 05:36:32 +0300") 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:145857 Archived-At: Eli Zaretskii writes: >> 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. It's relevant if potential contributors turn away/tune out/ignore the whole thing due to the unpleasant discussion.