From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: David Kastrup Newsgroups: gmane.emacs.devel Subject: Re: The poor state of documentation of pcase like things. Date: Fri, 18 Dec 2015 11:13:18 +0100 Message-ID: <87vb7wdpz5.fsf@fencepost.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> NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable X-Trace: ger.gmane.org 1450433622 30317 80.91.229.3 (18 Dec 2015 10:13:42 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Fri, 18 Dec 2015 10:13:42 +0000 (UTC) Cc: Rasmus , 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:13:41 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 1a9s2e-0002A3-Eh for ged-emacs-devel@m.gmane.org; Fri, 18 Dec 2015 11:13:40 +0100 Original-Received: from localhost ([::1]:59336 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1a9s2b-0000C4-Nr for ged-emacs-devel@m.gmane.org; Fri, 18 Dec 2015 05:13:37 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:44585) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1a9s2Q-0000Bu-0i for emacs-devel@gnu.org; Fri, 18 Dec 2015 05:13:26 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1a9s2P-0000De-56 for emacs-devel@gnu.org; Fri, 18 Dec 2015 05:13:25 -0500 Original-Received: from fencepost.gnu.org ([2001:4830:134:3::e]:54740) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1a9s2J-0000C4-95; Fri, 18 Dec 2015 05:13:19 -0500 Original-Received: from localhost ([127.0.0.1]:51168 helo=lola) by fencepost.gnu.org with esmtp (Exim 4.82) (envelope-from ) id 1a9s2I-0002qA-NG; Fri, 18 Dec 2015 05:13:18 -0500 Original-Received: by lola (Postfix, from userid 1000) id 61F08E0009; Fri, 18 Dec 2015 11:13:18 +0100 (CET) In-Reply-To: <8360zwxgbu.fsf@gnu.org> (Eli Zaretskii's message of "Fri, 18 Dec 2015 11:21:25 +0200") User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/25.1.50 (gnu/linux) 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:196460 Archived-At: Eli Zaretskii writes: >> From: Rasmus >> Date: Fri, 18 Dec 2015 10:12:00 +0100 >>=20 >> > 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. >>=20 >> But by lifting it, it would appear more prominently in the TOC. > > Only in the printed book, maybe. The TOC of the Info manual is flat: > all the nodes appear on the same level. Are we talking about the same Info manual here? That of Emacs? That with the =E2=80=94 The Detailed Node Listing =E2=80=94 =E2=80=94=E2=80=94=E2=80=94=E2=80=94=E2=80=94=E2=80=94=E2=80=94=E2=80= =94=E2=80=94=E2=80=94=E2=80=94 Here are some other nodes which are really subnodes of the ones already listed, mentioned here so you can get to them in one step: section? --=20 David Kastrup