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: Fri, 18 Dec 2015 10:30:51 +0000 Message-ID: <87r3ik59r8.fsf@russet.org.uk> References: <20151216202605.GA3752@acm.fritz.box> <87fuz0ydvb.fsf@russet.org.uk> <83poy4xm60.fsf@gnu.org> NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain X-Trace: ger.gmane.org 1450434679 16576 80.91.229.3 (18 Dec 2015 10:31:19 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Fri, 18 Dec 2015 10:31:19 +0000 (UTC) Cc: acm@muc.de, kaushal.modi@gmail.com, emacs-devel@gnu.org To: Eli Zaretskii Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Fri Dec 18 11:31:14 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 1a9sJW-0002Fb-GQ for ged-emacs-devel@m.gmane.org; Fri, 18 Dec 2015 11:31:06 +0100 Original-Received: from localhost ([::1]:59458 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1a9sJV-0002wJ-T8 for ged-emacs-devel@m.gmane.org; Fri, 18 Dec 2015 05:31:05 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:48888) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1a9sJR-0002tn-EP for emacs-devel@gnu.org; Fri, 18 Dec 2015 05:31:02 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1a9sJQ-0004tW-GK for emacs-devel@gnu.org; Fri, 18 Dec 2015 05:31:01 -0500 Original-Received: from cheviot12.ncl.ac.uk ([128.240.234.12]:34890) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1a9sJJ-0004sR-OM; Fri, 18 Dec 2015 05:30:53 -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 1a9sJI-0003Os-9p; Fri, 18 Dec 2015 10:30:52 +0000 Original-Received: from jangai.ncl.ac.uk ([10.66.67.223] helo=localhost) by smtpauth.ncl.ac.uk with esmtpsa (TLSv1:AES128-SHA:128) (Exim 4.63) (envelope-from ) id 1a9sJH-0004no-SO; Fri, 18 Dec 2015 10:30:51 +0000 In-Reply-To: <83poy4xm60.fsf@gnu.org> (Eli Zaretskii's message of "Fri, 18 Dec 2015 09:15:19 +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:196461 Archived-At: Eli Zaretskii writes: >> From: phillip.lord@russet.org.uk (Phillip Lord) >> Date: Thu, 17 Dec 2015 21:16:56 +0000 >> Cc: Alan Mackenzie , Emacs developers >> >> Could I suggest [pcase] be promoted in the manual a >> little. Currently, it's a subnode of "conditionals", but pattern >> match is really a form of control flow in its own right. > > If that's your itch, feel free to scratch it. I was suggesting it for John as he was going to write a tutorial. > IMO, that's largely a waste of your time and energy: the manual is > rarely if ever read in its entirety, or even in large portions. Most > of its uses is to quickly find the subject whose description you need, > hopefully by using the Info-index command ("i TOPIC RET"), and read > that and perhaps some of the cross-references there. With this use > case, the level on which a description is found is irrelevant. It's true. But you have to know to search for something in the first place. Also, I might well have searched for "destructuring" -- which now hits the seq.el documentation (implemented with pcase, but not linking to it). Phil