From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Alan Mackenzie Newsgroups: gmane.emacs.devel Subject: Re: The poor state of documentation of pcase like things. Date: Thu, 17 Dec 2015 21:26:33 +0000 Message-ID: <20151217212633.GC1888@acm.fritz.box> References: <20151216202605.GA3752@acm.fritz.box> NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Trace: ger.gmane.org 1450387485 22991 80.91.229.3 (17 Dec 2015 21:24:45 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Thu, 17 Dec 2015 21:24:45 +0000 (UTC) To: Kaushal Modi , Emacs developers Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Thu Dec 17 22:24:32 2015 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 1a9g2I-0005vk-V6 for ged-emacs-devel@m.gmane.org; Thu, 17 Dec 2015 22:24:31 +0100 Original-Received: from localhost ([::1]:57257 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1a9g2I-0001OJ-4k for ged-emacs-devel@m.gmane.org; Thu, 17 Dec 2015 16:24:30 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:56059) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1a9g2E-0001Nj-TL for emacs-devel@gnu.org; Thu, 17 Dec 2015 16:24:27 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1a9g2B-0003JT-KP for emacs-devel@gnu.org; Thu, 17 Dec 2015 16:24:26 -0500 Original-Received: from mail.muc.de ([193.149.48.3]:41220) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1a9g2B-0003JL-AY for emacs-devel@gnu.org; Thu, 17 Dec 2015 16:24:23 -0500 Original-Received: (qmail 27639 invoked by uid 3782); 17 Dec 2015 21:24:21 -0000 Original-Received: from acm.muc.de (p5B146235.dip0.t-ipconnect.de [91.20.98.53]) by colin.muc.de (tmda-ofmipd) with ESMTP; Thu, 17 Dec 2015 22:24:20 +0100 Original-Received: (qmail 4598 invoked by uid 1000); 17 Dec 2015 21:26:33 -0000 Content-Disposition: inline In-Reply-To: User-Agent: Mutt/1.5.23 (2014-03-12) X-Delivery-Agent: TMDA/1.1.12 (Macallan) X-Primary-Address: acm@muc.de X-detected-operating-system: by eggs.gnu.org: FreeBSD 9.x X-Received-From: 193.149.48.3 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:196431 Archived-At: Hello, John. On Thu, Dec 17, 2015 at 08:34:27AM -0800, John Wiegley wrote: > >>>>> Kaushal Modi writes: > > I would welcome a short tutorial on how (and why) to use pcase. > There are several examples shown here: > http://www.emacswiki.org/emacs/PatternMatching > pcase makes a lot more sense if you're used to pattern matching in functional > languages, where you describe a pattern (not unlike destructuring-bind) whose > "shape" is intended to match the set of shapes you want to successful match > against. > Since pattern matching like this isn't something I had ever encountered > outside of FP, I agree that a tutorial is in order. I'm willing to volunteer > for this. An external tutorial is all well and good, and very useful. But it is drifting off topic ever so slightly. That topic is the state of the the documentation about pcase etc., _inside_ Emacs, in its doc strings and the Elisp manual. Can we take it that that documentation will be fixed before the release of 25.1? > -- > John Wiegley GPG fingerprint = 4710 CF98 AF9B 327B B80F > http://newartisans.com 60E1 46C4 BD1A 7AC1 4BA2 -- Alan Mackenzie (Nuremberg, Germany).