From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Drew Adams Newsgroups: gmane.emacs.devel Subject: RE: The poor state of documentation of pcase like things. Date: Sun, 3 Jan 2016 22:19:18 -0800 (PST) Message-ID: References: <20151216202605.GA3752@acm.fritz.box> <87bn95m9eg.fsf@fencepost.gnu.org> <5686CDFB.2010105@dancol.org> <83fuygcs5g.fsf@gnu.org> <56886E32.70305@yandex.ru> <83si2f9ve4.fsf@gnu.org> <56889EC3.3040108@yandex.ru> <877fjrkpdf.fsf@fencepost.gnu.org> <56892334.4000106@yandex.ru> <8760zakb7q.fsf@fencepost.gnu.org> <56892BDA.6060103@dancol.org> <871t9yk98g.fsf@fencepost.gnu.org> <568936F0.3060505@yandex.ru> <87wprqitj5.fsf@fencepost.gnu.org> <56893C8C.3060200@yandex.ru> <87oad2irtd.fsf@fencepost.gnu.org> <5689456A.1010601@yandex.ru> <87egdy8tyz.fsf@fencepost.gnu.org> <56895FDE.4060406@yandex.ru> <8760za8r4a.fsf@fencepost.gnu.org> <87h9iunkcg.fsf@web.de> NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: quoted-printable X-Trace: ger.gmane.org 1451888395 4407 80.91.229.3 (4 Jan 2016 06:19:55 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Mon, 4 Jan 2016 06:19:55 +0000 (UTC) To: Michael Heerdegen , emacs-devel@gnu.org Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Mon Jan 04 07:19:43 2016 Return-path: Envelope-to: ged-emacs-devel@m.gmane.org Original-Received: from lists.gnu.org ([208.118.235.17]) by plane.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1aFyUY-0008Dy-8l for ged-emacs-devel@m.gmane.org; Mon, 04 Jan 2016 07:19:42 +0100 Original-Received: from localhost ([::1]:43977 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1aFyUX-0003ZV-HD for ged-emacs-devel@m.gmane.org; Mon, 04 Jan 2016 01:19:41 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:44887) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1aFyUK-0003ZH-PG for emacs-devel@gnu.org; Mon, 04 Jan 2016 01:19:29 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1aFyUF-0002qX-QQ for emacs-devel@gnu.org; Mon, 04 Jan 2016 01:19:28 -0500 Original-Received: from userp1040.oracle.com ([156.151.31.81]:50618) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1aFyUF-0002qQ-Jb for emacs-devel@gnu.org; Mon, 04 Jan 2016 01:19:23 -0500 Original-Received: from userv0021.oracle.com (userv0021.oracle.com [156.151.31.71]) by userp1040.oracle.com (Sentrion-MTA-4.3.2/Sentrion-MTA-4.3.2) with ESMTP id u046JK9h009517 (version=TLSv1 cipher=DHE-RSA-AES256-SHA bits=256 verify=FAIL); Mon, 4 Jan 2016 06:19:21 GMT Original-Received: from aserv0121.oracle.com (aserv0121.oracle.com [141.146.126.235]) by userv0021.oracle.com (8.13.8/8.13.8) with ESMTP id u046JKJS016654 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=FAIL); Mon, 4 Jan 2016 06:19:20 GMT Original-Received: from abhmp0010.oracle.com (abhmp0010.oracle.com [141.146.116.16]) by aserv0121.oracle.com (8.13.8/8.13.8) with ESMTP id u046JKsx022085; Mon, 4 Jan 2016 06:19:20 GMT In-Reply-To: <87h9iunkcg.fsf@web.de> X-Priority: 3 X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.9 (901082) [OL 12.0.6691.5000 (x86)] X-Source-IP: userv0021.oracle.com [156.151.31.71] X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.4.x-2.6.x [generic] X-Received-From: 156.151.31.81 X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: "Emacs development discussions." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Original-Sender: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.devel:197573 Archived-At: > I'll try to take care of that stuff. >=20 > After all, despite of the tone on both sides, I think we came to > some conclusions: >=20 > - The pcase docs must be updated, esp. wrt quoting/ backquote, and > missing stuff (e.g. first matching branches' body is executed, > remaining branches are ignored). >=20 > - We should not use it in cases where a different thing (esp. cl-case) > exactly fits. "Promoters" should use it sparse in contributions and > only in cases where it improves readability or makes the case > distinction clearer (given the reader read the documentation). Others > should accept that some people find it handy and will use it in such > cases in their contributions. >=20 > - Occurrences in the sources must be revised. >=20 > The only substantial difference, I think, was whether the design and > concept of pcase is useful. I think it's ok when people have different > preferences here (like with `loop', which I personally avoid btw). >=20 > Thanks everyone, Michael. A very constructive contribution to the discussion, IMO. Thanks for taking a stab at the doc improvement. That will be a great help, including in terms of guiding our use of `pcase'. And thanks for the consensus summary - sounds good to me.