From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: phillip.lord@russet.org.uk (Phillip Lord) Newsgroups: gmane.emacs.devel Subject: Re: The poor state of documentation of pcase like things. Date: Sun, 20 Dec 2015 22:54:39 +0000 Message-ID: <87vb7sg28g.fsf@russet.org.uk> References: <20151216202605.GA3752@acm.fritz.box> <87fuz0ydvb.fsf@russet.org.uk> <83poy4xm60.fsf@gnu.org> <871tak15pb.fsf@gmx.us> <8360zwxgbu.fsf@gnu.org> <87vb7wdpz5.fsf@fencepost.gnu.org> <831takxccb.fsf@gnu.org> <87egej3dvb.fsf@russet.org.uk> <83h9jfwuab.fsf@gnu.org> <83r3iivg02.fsf@gnu.org> <87fuyyllat.fsf@fencepost.gnu.org> <83mvt6vdli.fsf@gnu.org> <878u4qnpml.fsf@russet.org.uk> <83wpsatat1.fsf@gnu.org> <87r3iim611.fsf@russet.org.uk> <83vb7tu6v4.fsf@gnu.org> NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain X-Trace: ger.gmane.org 1450652120 9416 80.91.229.3 (20 Dec 2015 22:55:20 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Sun, 20 Dec 2015 22:55:20 +0000 (UTC) Cc: dak@gnu.org, rasmus@gmx.us, emacs-devel@gnu.org To: Eli Zaretskii Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Sun Dec 20 23:55:12 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 1aAmsg-0002CD-1M for ged-emacs-devel@m.gmane.org; Sun, 20 Dec 2015 23:55:10 +0100 Original-Received: from localhost ([::1]:42302 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1aAmsf-00046u-Dp for ged-emacs-devel@m.gmane.org; Sun, 20 Dec 2015 17:55:09 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:53551) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1aAmsT-00046m-7K for emacs-devel@gnu.org; Sun, 20 Dec 2015 17:54:58 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1aAmsS-0001AG-9N for emacs-devel@gnu.org; Sun, 20 Dec 2015 17:54:57 -0500 Original-Received: from cheviot12.ncl.ac.uk ([128.240.234.12]:43301) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1aAmsL-00016v-C3; Sun, 20 Dec 2015 17:54:49 -0500 Original-Received: from smtpauth-vm.ncl.ac.uk ([10.8.233.129] helo=smtpauth.ncl.ac.uk) by cheviot12.ncl.ac.uk with esmtp (Exim 4.63) (envelope-from ) id 1aAmsG-0000X9-Bx; Sun, 20 Dec 2015 22:54:44 +0000 Original-Received: from cpc6-benw10-2-0-cust45.gate.cable.virginm.net ([92.238.179.46] helo=localhost) by smtpauth.ncl.ac.uk with esmtpsa (TLSv1:AES128-SHA:128) (Exim 4.63) (envelope-from ) id 1aAmsG-0008VD-Ej; Sun, 20 Dec 2015 22:54:44 +0000 In-Reply-To: <83vb7tu6v4.fsf@gnu.org> (Eli Zaretskii's message of "Sun, 20 Dec 2015 05:38:39 +0200") User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/24.5 (gnu/linux) X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6.x X-Received-From: 128.240.234.12 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:196577 Archived-At: Eli Zaretskii writes: >> >> Simple change would be from: >> >> Conditionals >> >> * Pattern matching case statement:: How to use @code{pcase}. >> >> >> to >> >> Pattern Matching >> >> * Conditional:: How to use @code{pcase} > > The last line can't be done, unless the node names are changed as > well. Right now the pcase description is in the child node of > "Conditionals" whose name is "Pattern matching case statement". > > Also, I think having 2 nodes named "Conditionals" and "Conditional" > will be too confusing. Agreed. Hostage to fortune, if another pattern matching conditional is invented. "Pattern Matching" and "pcase" would work. >> Pattern Matching >> >> (this would contain a generalised introduction and tutorial, based >> around pcase) >> >> * List Clauses:: Destructuring Lists >> * Predicates:: Matching with predicate functions >> * Booleans:: and and or >> * Guards:: I don't quite understand guards >> * Conditionals:: pcase >> * Binding:: pcase-let >> * Lambda:: pcase-lambda > > These would be too short to justify a separate node, IMO. They might be, yes. I'd write it and see. With examples for each, they might get long enough. > >> * New Patterns:: pcase-macro, with description of seq and map support. > > We avoid using "new" in manuals, because they are that only for one > release. Sorry, poor working "Creating New Patterns" -- or perhaps "extending pattern matching". Phil