From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: "Drew Adams" Newsgroups: gmane.emacs.devel Subject: RE: describe-bindings: ^L, bad order, naming Date: Sat, 12 Nov 2005 13:41:12 -0800 Message-ID: References: <87ek5lehq3.fsf@jurta.org> NNTP-Posting-Host: main.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit X-Trace: sea.gmane.org 1131831818 12782 80.91.229.2 (12 Nov 2005 21:43:38 GMT) X-Complaints-To: usenet@sea.gmane.org NNTP-Posting-Date: Sat, 12 Nov 2005 21:43:38 +0000 (UTC) Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Sat Nov 12 22:43:37 2005 Return-path: Original-Received: from lists.gnu.org ([199.232.76.165]) by ciao.gmane.org with esmtp (Exim 4.43) id 1Eb37t-0002r1-6F for ged-emacs-devel@m.gmane.org; Sat, 12 Nov 2005 22:41:33 +0100 Original-Received: from localhost ([127.0.0.1] helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1Eb37s-00009B-BL for ged-emacs-devel@m.gmane.org; Sat, 12 Nov 2005 16:41:32 -0500 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1Eb37h-00008t-VD for emacs-devel@gnu.org; Sat, 12 Nov 2005 16:41:22 -0500 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1Eb37g-00008d-CI for emacs-devel@gnu.org; Sat, 12 Nov 2005 16:41:21 -0500 Original-Received: from [199.232.76.173] (helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1Eb37g-00008a-8f for emacs-devel@gnu.org; Sat, 12 Nov 2005 16:41:20 -0500 Original-Received: from [148.87.122.30] (helo=rgminet01.oracle.com) by monty-python.gnu.org with esmtp (TLS-1.0:DHE_RSA_3DES_EDE_CBC_SHA:24) (Exim 4.34) id 1Eb37g-0004A2-CY for emacs-devel@gnu.org; Sat, 12 Nov 2005 16:41:20 -0500 Original-Received: from rgmsgw300.us.oracle.com (rgmsgw300.us.oracle.com [138.1.186.49]) by rgminet01.oracle.com (Switch-3.1.6/Switch-3.1.6) with ESMTP id jACLfH9V027190 for ; Sat, 12 Nov 2005 14:41:18 -0700 Original-Received: from rgmsgw300.us.oracle.com (localhost [127.0.0.1]) by rgmsgw300.us.oracle.com (Switch-3.1.7/Switch-3.1.7) with ESMTP id jACLfHl2009743 for ; Sat, 12 Nov 2005 14:41:17 -0700 Original-Received: from dradamslap (dhcp-amer-csvpn-gw2-141-144-73-250.vpn.oracle.com [141.144.73.250]) by rgmsgw300.us.oracle.com (Switch-3.1.7/Switch-3.1.7) with SMTP id jACLfHOu009736 (version=TLSv1/SSLv3 cipher=RC4-MD5 bits=128 verify=NO) for ; Sat, 12 Nov 2005 14:41:17 -0700 Original-To: X-Priority: 3 (Normal) X-MSMail-Priority: Normal X-Mailer: Microsoft Outlook IMO, Build 9.0.6604 (9.0.2911.0) In-Reply-To: <87ek5lehq3.fsf@jurta.org> Importance: Normal X-MimeOLE: Produced By Microsoft MimeOLE V6.00.2800.1506 X-Brightmail-Tracker: AAAAAQAAAAI= X-Whitelist: TRUE 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:45848 Archived-At: >>> Couldn't there be a list of all groups in the beginning, with links >>> going to the bindings belonging to the group? >> >> Like in the *Help* buffer created by `C-h m'? > > Yup. That would be fine. > Outline mode, as suggested by Eli, is OK only if it doesn't require > people to know some keys in order to even look up the keys. By default, Outline mode is harmless and doesn't require to know its keys to read the Help buffer. Advanced users should know Outline keys to use it and to hide/show uninteresting parts. If the point is to make the less interesting parts less visible to start with (so, less distracting), then Outline mode would help only if it hid such stuff, by default. 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 Web and in technical documents (e.g. reference-book chapters): a preliminary TOC with links.