From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Eli Zaretskii Newsgroups: gmane.emacs.devel Subject: Re: The poor state of documentation of pcase like things. Date: Sat, 19 Dec 2015 22:58:50 +0200 Message-ID: <83wpsatat1.fsf@gnu.org> 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> Reply-To: Eli Zaretskii NNTP-Posting-Host: plane.gmane.org X-Trace: ger.gmane.org 1450558731 1523 80.91.229.3 (19 Dec 2015 20:58:51 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Sat, 19 Dec 2015 20:58:51 +0000 (UTC) Cc: dak@gnu.org, rasmus@gmx.us, emacs-devel@gnu.org To: phillip.lord@russet.org.uk (Phillip Lord) Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Sat Dec 19 21:58:46 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 1aAOaS-0004GD-U9 for ged-emacs-devel@m.gmane.org; Sat, 19 Dec 2015 21:58:45 +0100 Original-Received: from localhost ([::1]:38609 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1aAOaS-0006cL-6w for ged-emacs-devel@m.gmane.org; Sat, 19 Dec 2015 15:58:44 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:42858) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1aAOaG-0006c6-3x for emacs-devel@gnu.org; Sat, 19 Dec 2015 15:58:33 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1aAOaF-00089t-9A for emacs-devel@gnu.org; Sat, 19 Dec 2015 15:58:32 -0500 Original-Received: from fencepost.gnu.org ([2001:4830:134:3::e]:49875) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1aAOa8-000890-TH; Sat, 19 Dec 2015 15:58:24 -0500 Original-Received: from 84.94.185.246.cable.012.net.il ([84.94.185.246]:4215 helo=HOME-C4E4A596F7) by fencepost.gnu.org with esmtpsa (TLS1.2:RSA_AES_128_CBC_SHA1:128) (Exim 4.82) (envelope-from ) id 1aAOa8-0000nd-4y; Sat, 19 Dec 2015 15:58:24 -0500 In-reply-to: <878u4qnpml.fsf@russet.org.uk> (phillip.lord@russet.org.uk) X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 2001:4830:134:3::e 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:196525 Archived-At: > From: phillip.lord@russet.org.uk (Phillip Lord) > Cc: David Kastrup , , > Date: Sat, 19 Dec 2015 20:35:14 +0000 > > 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. Sorry, I'm not following. If we think the second instance of "Conditionals" is not the best text, we can change it at will. Only the first one must me identical to the node name. The second one is "Conditionals" because it was produced by a program and I left it unchanged, but it can be changed if we want to.