From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Eli Zaretskii Newsgroups: gmane.emacs.devel Subject: Re: order of manuals in Info... Date: Tue, 27 Jan 2009 05:40:50 +0200 Message-ID: References: <007501c97f79$14a0c260$0200a8c0@us.oracle.com> <00d601c98008$cbdea6b0$c2b22382@us.oracle.com> Reply-To: Eli Zaretskii NNTP-Posting-Host: lo.gmane.org X-Trace: ger.gmane.org 1233027673 20824 80.91.229.12 (27 Jan 2009 03:41:13 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Tue, 27 Jan 2009 03:41:13 +0000 (UTC) Cc: emacs-devel@gnu.org To: Drew Adams Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Tue Jan 27 04:42:26 2009 Return-path: Envelope-to: ged-emacs-devel@m.gmane.org Original-Received: from lists.gnu.org ([199.232.76.165]) by lo.gmane.org with esmtp (Exim 4.50) id 1LReq7-0006Pn-Ly for ged-emacs-devel@m.gmane.org; Tue, 27 Jan 2009 04:42:16 +0100 Original-Received: from localhost ([127.0.0.1]:47066 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1LReop-0000eH-NE for ged-emacs-devel@m.gmane.org; Mon, 26 Jan 2009 22:40:55 -0500 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1LReol-0000b9-2A for emacs-devel@gnu.org; Mon, 26 Jan 2009 22:40:51 -0500 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1LReok-0000Yr-5H for emacs-devel@gnu.org; Mon, 26 Jan 2009 22:40:50 -0500 Original-Received: from [199.232.76.173] (port=48403 helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1LReoj-0000YV-VW for emacs-devel@gnu.org; Mon, 26 Jan 2009 22:40:50 -0500 Original-Received: from mtaout1.012.net.il ([84.95.2.1]:43622) by monty-python.gnu.org with esmtp (Exim 4.60) (envelope-from ) id 1LReoj-0002En-Ib for emacs-devel@gnu.org; Mon, 26 Jan 2009 22:40:49 -0500 Original-Received: from conversion-daemon.i-mtaout1.012.net.il by i-mtaout1.012.net.il (HyperSendmail v2007.08) id <0KE4006001MWY400@i-mtaout1.012.net.il> for emacs-devel@gnu.org; Tue, 27 Jan 2009 05:41:06 +0200 (IST) Original-Received: from HOME-C4E4A596F7 ([87.70.255.234]) by i-mtaout1.012.net.il (HyperSendmail v2007.08) with ESMTPA id <0KE4005ER28ERZC0@i-mtaout1.012.net.il>; Tue, 27 Jan 2009 05:41:05 +0200 (IST) In-reply-to: <00d601c98008$cbdea6b0$c2b22382@us.oracle.com> X-012-Sender: halo1@inter.net.il X-detected-operating-system: by monty-python.gnu.org: Solaris 9.1 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:108286 Archived-At: > From: "Drew Adams" > Cc: > Date: Mon, 26 Jan 2009 14:52:41 -0800 > > > > > 1. What is the ordering scheme used in emacs -Q for the > > > Info manuals? > > > > They are ordered by (loose) topics, with the "main" manuals first. > > No problem with that. > > But what are the "main" manuals, besides the five I mentioned: > Info, Emacs, Emacs FAQ, Emacs Lisp Intro, and Elisp? None. > The question was about the order of those manuals that follow the five main > manuals I mentioned. What's the rationale? There are only 4 groups of manuals after these 5: Editing modes, Network features, Misc features, and Lisp libraries. Inside each group, the manuals are ordered in alphabetic order. Editing modes is first for obvious (I hope) reasons; Networking is before Misc for likewise obvious reasons ("misc" should always be last); and libraries are mainly for Lisp programmers, so they are last. > Do you think the current order is the best one? > Is there room for improvement? There's always room for improvement, but I think the current order is fine, and I think there are much more important problems to work on now to help Emacs 23 be released sooner rather than later. > And what about question #2: shortening the long lines? Why is this so important? shorter description lose information. I think the current descriptions strike a reasonably good balance.