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: Sat, 19 Dec 2015 20:35:14 +0000 Message-ID: <878u4qnpml.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> NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain X-Trace: ger.gmane.org 1450557363 14826 80.91.229.3 (19 Dec 2015 20:36:03 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Sat, 19 Dec 2015 20:36:03 +0000 (UTC) Cc: David Kastrup , rasmus@gmx.us, emacs-devel@gnu.org To: Eli Zaretskii Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Sat Dec 19 21:35:54 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 1aAOEI-0004M8-Np for ged-emacs-devel@m.gmane.org; Sat, 19 Dec 2015 21:35:50 +0100 Original-Received: from localhost ([::1]:38565 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1aAOEI-0001rb-5a for ged-emacs-devel@m.gmane.org; Sat, 19 Dec 2015 15:35:50 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:37383) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1aAODp-0001oQ-W9 for emacs-devel@gnu.org; Sat, 19 Dec 2015 15:35:22 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1aAODp-0003Bh-4p for emacs-devel@gnu.org; Sat, 19 Dec 2015 15:35:21 -0500 Original-Received: from cheviot22.ncl.ac.uk ([128.240.234.22]:42108) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1aAODk-0003AV-2U; Sat, 19 Dec 2015 15:35:16 -0500 Original-Received: from smtpauth-vm.ncl.ac.uk ([10.8.233.129] helo=smtpauth.ncl.ac.uk) by cheviot22.ncl.ac.uk with esmtp (Exim 4.63) (envelope-from ) id 1aAODj-00072P-EZ; Sat, 19 Dec 2015 20:35:15 +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 1aAODj-00043H-98; Sat, 19 Dec 2015 20:35:15 +0000 In-Reply-To: <83mvt6vdli.fsf@gnu.org> (Eli Zaretskii's message of "Sat, 19 Dec 2015 14:15:37 +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.22 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:196523 Archived-At: Eli Zaretskii writes: >> >> Conditionals >> >> * Pattern matching case statement:: How to use @code{pcase}. >> >> Nonlocal Exits >> >> * Catch and Throw:: Nonlocal exits for the program's own purposes. >> * Examples of Catch:: Showing how such nonlocal exits can be written. >> * Errors:: How errors are signaled and handled. >> * Cleanups:: Arranging to run a cleanup form if an >> >> Note that "Conditionals" now appears twice: as a proper node name and as >> a newly added section containing only "pcase" and nothing else. > > Yes, and that is a problem because...? I would think that it would make more sense to have "Pattern Matching" at top-level. pcase is conditional, but neither pcase-let nor pcase-lambda really is. The "conditional" can have a short section saying "pcase is like case but with pattern matching", as can the "let" and "lambda" documentation. Phil