From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Miles Bader Newsgroups: gmane.emacs.devel Subject: Re: describe-bindings: ^L, bad order, naming Date: Sun, 13 Nov 2005 06:53:33 +0900 Message-ID: References: <87ek5lehq3.fsf@jurta.org> Reply-To: snogglethorpe@gmail.com, miles@gnu.org NNTP-Posting-Host: main.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=ISO-8859-1 Content-Transfer-Encoding: quoted-printable X-Trace: sea.gmane.org 1131832453 14184 80.91.229.2 (12 Nov 2005 21:54:13 GMT) X-Complaints-To: usenet@sea.gmane.org NNTP-Posting-Date: Sat, 12 Nov 2005 21:54:13 +0000 (UTC) Cc: emacs-devel@gnu.org Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Sat Nov 12 22:54:06 2005 Return-path: Original-Received: from lists.gnu.org ([199.232.76.165]) by ciao.gmane.org with esmtp (Exim 4.43) id 1Eb3Jl-00061s-95 for ged-emacs-devel@m.gmane.org; Sat, 12 Nov 2005 22:53:49 +0100 Original-Received: from localhost ([127.0.0.1] helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1Eb3Jk-0001sO-PE for ged-emacs-devel@m.gmane.org; Sat, 12 Nov 2005 16:53:48 -0500 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1Eb3JX-0001sH-Iv for emacs-devel@gnu.org; Sat, 12 Nov 2005 16:53:35 -0500 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1Eb3JW-0001s5-5k for emacs-devel@gnu.org; Sat, 12 Nov 2005 16:53:35 -0500 Original-Received: from [199.232.76.173] (helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1Eb3JW-0001s1-10 for emacs-devel@gnu.org; Sat, 12 Nov 2005 16:53:34 -0500 Original-Received: from [64.233.184.204] (helo=wproxy.gmail.com) by monty-python.gnu.org with esmtp (Exim 4.34) id 1Eb3JW-0004ke-BI for emacs-devel@gnu.org; Sat, 12 Nov 2005 16:53:34 -0500 Original-Received: by wproxy.gmail.com with SMTP id 69so1622532wri for ; Sat, 12 Nov 2005 13:53:33 -0800 (PST) DomainKey-Signature: a=rsa-sha1; q=dns; c=nofws; s=beta; d=gmail.com; h=received:message-id:date:from:reply-to:to:subject:cc:in-reply-to:mime-version:content-type:content-transfer-encoding:content-disposition:references; b=bMIjjuXl6Ii7MyqhTewO/lcYHncRWpi7WHFiLReyM6T33JABsp5Fb02MUd0E6G0us1evG0AUo+rWNOuB4grX5E1QQVrR2FDdDrCkTKQOksZsrMJasi/nEuxGH1yb1wFaavPcYO4585T+ZFkRqW8GCPBCMaEjuBNrzu/SEt4lNOI= Original-Received: by 10.54.157.8 with SMTP id f8mr1859052wre; Sat, 12 Nov 2005 13:53:33 -0800 (PST) Original-Received: by 10.54.160.4 with HTTP; Sat, 12 Nov 2005 13:53:33 -0800 (PST) Original-To: Drew Adams In-Reply-To: Content-Disposition: inline X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: "Emacs development discussions." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Original-Sender: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.devel:45849 Archived-At: 2005/11/13, Drew Adams : > Why not just do what the OP suggested: list the section titles in the > beginning, linked to the sections themselves (exactly as in the *Help* > buffer). That would be perfect. Such an approach is common both on the We= b > and in technical documents (e.g. reference-book chapters): a preliminary = TOC > with links. Though in practice, it's highly annoying in for instance describe-mode, because the "table of contents" is usually very bloated and pushes useful text off the screen. -Miles -- Do not taunt Happy Fun Ball.