From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: John Wiegley Newsgroups: gmane.emacs.devel Subject: Re: The poor state of documentation of pcase like things. Date: Mon, 04 Jan 2016 14:07:57 -0800 Message-ID: References: <20151216202605.GA3752@acm.fritz.box> <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 X-Trace: ger.gmane.org 1451945301 5496 80.91.229.3 (4 Jan 2016 22:08:21 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Mon, 4 Jan 2016 22:08:21 +0000 (UTC) Cc: Michael Heerdegen , emacs-devel@gnu.org To: Drew Adams Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Mon Jan 04 23:08:15 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 1aGDIV-00069U-1m for ged-emacs-devel@m.gmane.org; Mon, 04 Jan 2016 23:08:15 +0100 Original-Received: from localhost ([::1]:47303 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1aGDIU-0001er-BZ for ged-emacs-devel@m.gmane.org; Mon, 04 Jan 2016 17:08:14 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:41407) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1aGDIQ-0001eJ-KM for emacs-devel@gnu.org; Mon, 04 Jan 2016 17:08:11 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1aGDIM-0001zl-6Y for emacs-devel@gnu.org; Mon, 04 Jan 2016 17:08:10 -0500 Original-Received: from mail-pa0-x231.google.com ([2607:f8b0:400e:c03::231]:35831) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1aGDIM-0001zf-17 for emacs-devel@gnu.org; Mon, 04 Jan 2016 17:08:06 -0500 Original-Received: by mail-pa0-x231.google.com with SMTP id do7so2804149pab.2 for ; Mon, 04 Jan 2016 14:08:06 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=from:to:cc:subject:in-reply-to:date:message-id:references :user-agent:mail-followup-to:mime-version:content-type; bh=fwH/BCtOvPgUZNOo2+02RDBHZE06PUg5CzATukQOSe0=; b=OxD8b3xXsc+6HWjsA3zSJkem9NxEChuPZR3Jrz9dKHQ8SQ12LzsKvgKuodwPWze4A1 0PvE7urhfuMeXDiuP8Yk+4KNZbprYUf03Yql5GvfdE9pA+j8Rr/yoL6oG0M4iGcbp7IQ NXtybuPVTZUeOMa8KDF3nD8DC8EGcYgpvz53rUjo7H3TYhiyJBlcEr7+bCFQWO7xRIWs OJp9vAI7qwd4kNVwvaiOdHO5pFTw6hl0PmBpAuAD8JEn74H/NgLaZqKbgGceC10Zi2WA dAatPmq63rBBi+kfNuwI6jdW8BdHvh1CunnGHS06WCVfWwzNGns2jV33U++/nzqH7ksB L/Xg== X-Received: by 10.66.236.129 with SMTP id uu1mr25162967pac.158.1451945285633; Mon, 04 Jan 2016 14:08:05 -0800 (PST) Original-Received: from Vulcan.local (76-234-68-79.lightspeed.frokca.sbcglobal.net. [76.234.68.79]) by smtp.gmail.com with ESMTPSA id c87sm25024546pfj.79.2016.01.04.14.08.04 (version=TLS1 cipher=AES128-SHA bits=128/128); Mon, 04 Jan 2016 14:08:04 -0800 (PST) X-Google-Original-From: "John Wiegley" Original-Received: by Vulcan.local (Postfix, from userid 501) id 515E41203089F; Mon, 4 Jan 2016 14:08:04 -0800 (PST) In-Reply-To: (Drew Adams's message of "Sun, 3 Jan 2016 22:19:18 -0800 (PST)") User-Agent: Gnus/5.130014 (Ma Gnus v0.14) Emacs/24.5 (darwin) Mail-Followup-To: Drew Adams , Michael Heerdegen , emacs-devel@gnu.org X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 2607:f8b0:400e:c03::231 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:197631 Archived-At: >>>>> Drew Adams writes: >> After all, despite of the tone on both sides, I think we came to >> some conclusions: >> >> - 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). >> >> - 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. >> >> - Occurrences in the sources must be revised. >> >> 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). >> >> 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. Excellent summary and resolution, I agree. We can continue debate on emacs-tangents, but this is resolved now from emacs-devel's point of view. Michael and I will produce new documentation shortly. -- John Wiegley GPG fingerprint = 4710 CF98 AF9B 327B B80F http://newartisans.com 60E1 46C4 BD1A 7AC1 4BA2