From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Rasmus Newsgroups: gmane.emacs.devel Subject: Re: The poor state of documentation of pcase like things. Date: Fri, 18 Dec 2015 10:12:00 +0100 Message-ID: <871tak15pb.fsf@gmx.us> 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; charset=utf-8 Content-Transfer-Encoding: 8bit X-Trace: ger.gmane.org 1450429973 4895 80.91.229.3 (18 Dec 2015 09:12:53 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Fri, 18 Dec 2015 09:12:53 +0000 (UTC) To: emacs-devel@gnu.org Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Fri Dec 18 10:12:44 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 1a9r5a-0002Vf-B1 for ged-emacs-devel@m.gmane.org; Fri, 18 Dec 2015 10:12:38 +0100 Original-Received: from localhost ([::1]:59091 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1a9r5U-0004Nc-J9 for ged-emacs-devel@m.gmane.org; Fri, 18 Dec 2015 04:12:32 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:54569) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1a9r5R-0004NT-Fv for emacs-devel@gnu.org; Fri, 18 Dec 2015 04:12:30 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1a9r5L-0001w9-MD for emacs-devel@gnu.org; Fri, 18 Dec 2015 04:12:29 -0500 Original-Received: from plane.gmane.org ([80.91.229.3]:34749) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1a9r5L-0001vi-FM for emacs-devel@gnu.org; Fri, 18 Dec 2015 04:12:23 -0500 Original-Received: from list by plane.gmane.org with local (Exim 4.69) (envelope-from ) id 1a9r5E-00027j-0r for emacs-devel@gnu.org; Fri, 18 Dec 2015 10:12:16 +0100 Original-Received: from 62.80.108.14 ([62.80.108.14]) by main.gmane.org with esmtp (Gmexim 0.1 (Debian)) id 1AlnuQ-0007hv-00 for ; Fri, 18 Dec 2015 10:12:16 +0100 Original-Received: from rasmus by 62.80.108.14 with local (Gmexim 0.1 (Debian)) id 1AlnuQ-0007hv-00 for ; Fri, 18 Dec 2015 10:12:16 +0100 X-Injected-Via-Gmane: http://gmane.org/ Original-Lines: 25 Original-X-Complaints-To: usenet@ger.gmane.org X-Gmane-NNTP-Posting-Host: 62.80.108.14 Face: iVBORw0KGgoAAAANSUhEUgAAADAAAAAwCAAAAAByaaZbAAAAAnRSTlMA/iyWEiMAAAACYktH RAD/h4/MvwAAAAlwSFlzAAAASAAAAEgARslrPgAAAjNJREFUSMe1lsGNIzsMRH15+VQmlUqFwlAY CiMS9qDucdtuD7D78QX4YFtPJFVUSY/1l+Pxj0AbqOO36ZrfgTFytfa0EaD+DRBxTR0h4ukS+Q6Y UC2AJBZOJl+Ix1qNyYCrAhIg8xPwE4jE2DGqTqoNgjFfAEtUzDnUJRvPbYjHWhJvo6YMI+Y+JfxO yMAKN8Qu+oMA3ESfWT1WgGp4wzSCCL2p/iglZUC1Qm2ZUcY7N4Gvqj/iOoue3h88U89y9KL6Y1As CfWysvbMdHVftsCXGhqc1K5hWmABR057XPrksdYqwVWLqaqjt54x5uU8DBf1NJ97HPn1APkCdN2o EvoVeOaU5k5G6UuErcRHryiH6D9AfpuPZO2kThM4GlD388EEzcVmjhruCwCsgzgB0wYtU/c5mU2c QBOrssTMXbOrD8F/nK+gJiPKee7+GDA7NoR5WmVR+8io8FRSPV05FnfPDnHx1khENIWrusqCPlpF 8QjbVzOeUKI4z6xiyngCFJlq68W9d0oUCjWz1shF3EABNdQbUFAE5TAxKTQpKGzkdQOoUI7+l61i r1Nr5u1CqQ3kBxis/ZU6+vsFCIXq8ndTeAN9Aww2qp1D7xKMQ3Qfodj7d2S8VhNwKNAdIBuUnVLO U6Ic63wCREBZUMpayy5wrC+APFHXoetaq+iZ5XwDGveUirOGZSTIVLoPZd6E2xabPjexk3jffrl9 CUy3SD19a53OWN+fDgHydvXMf35r/I/AH5DaBVjP2kHeAAAAAElFTkSuQmCC User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/25.1.50 (gnu/linux) Cancel-Lock: sha1:1eHbotl/xtaMJPJzfv3uO7dxQoM= X-detected-operating-system: by eggs.gnu.org: Genre and OS details not recognized. X-Received-From: 80.91.229.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:196456 Archived-At: Eli Zaretskii writes: >> 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. > > 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. But by lifting it, it would appear more prominently in the TOC. This might cause interest on its own (I’m thinking about the pdf/tex version here). Rasmus -- I hear there's rumors on the, uh, Internets. . .