From mboxrd@z Thu Jan 1 00:00:00 1970 Path: main.gmane.org!not-for-mail From: Juri Linkov Newsgroups: gmane.emacs.devel Subject: Re: Info enhancements Date: Sun, 07 Dec 2003 23:54:45 +0200 Organization: JURTA Sender: emacs-devel-bounces+emacs-devel=quimby.gnus.org@gnu.org Message-ID: <87ad64cmzj.fsf@mail.jurta.org> References: <878ylrbbk4.fsf@mail.jurta.org> <200312051827.hB5IRfk17741@f7.net> <87isku20s6.fsf@mail.jurta.org> <200312071844.hB7Iiun11495@raven.dms.auburn.edu> NNTP-Posting-Host: deer.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Trace: sea.gmane.org 1070834458 29817 80.91.224.253 (7 Dec 2003 22:00:58 GMT) X-Complaints-To: usenet@sea.gmane.org NNTP-Posting-Date: Sun, 7 Dec 2003 22:00:58 +0000 (UTC) Cc: bob@rattlesnake.com, emacs-devel@gnu.org, karl@freefriends.org Original-X-From: emacs-devel-bounces+emacs-devel=quimby.gnus.org@gnu.org Sun Dec 07 23:00:54 2003 Return-path: Original-Received: from quimby.gnus.org ([80.91.224.244]) by deer.gmane.org with esmtp (Exim 3.35 #1 (Debian)) id 1AT6xS-0006xb-00 for ; Sun, 07 Dec 2003 23:00:54 +0100 Original-Received: from monty-python.gnu.org ([199.232.76.173]) by quimby.gnus.org with esmtp (Exim 3.35 #1 (Debian)) id 1AT6xS-0002IM-00 for ; Sun, 07 Dec 2003 23:00:54 +0100 Original-Received: from localhost ([127.0.0.1] helo=monty-python.gnu.org) by monty-python.gnu.org with esmtp (Exim 4.24) id 1AT7ur-0006aL-Tk for emacs-devel@quimby.gnus.org; Sun, 07 Dec 2003 18:02:17 -0500 Original-Received: from list by monty-python.gnu.org with tmda-scanned (Exim 4.24) id 1AT7t5-0005k2-AX for emacs-devel@gnu.org; Sun, 07 Dec 2003 18:00:27 -0500 Original-Received: from mail by monty-python.gnu.org with spam-scanned (Exim 4.24) id 1AT7sV-0004lj-CX for emacs-devel@gnu.org; Sun, 07 Dec 2003 18:00:22 -0500 Original-Received: from [64.246.52.22] (helo=ns5.tangramltd.com) by monty-python.gnu.org with esmtp (TLSv1:DES-CBC3-SHA:168) (Exim 4.24) id 1AT7sL-0004Mw-2Y for emacs-devel@gnu.org; Sun, 07 Dec 2003 17:59:41 -0500 Original-Received: from 80-235-42-190-dsl.mus.estpak.ee ([80.235.42.190] helo=mail.jurta.org) by ns5.tangramltd.com with esmtp (Exim 4.20) id 1AT6ul-000410-Po; Sun, 07 Dec 2003 23:58:08 +0200 Original-To: Luc Teirlinck In-Reply-To: <200312071844.hB7Iiun11495@raven.dms.auburn.edu> (Luc Teirlinck's message of "Sun, 7 Dec 2003 12:44:56 -0600 (CST)") User-Agent: Gnus/5.1003 (Gnus v5.10.3) Emacs/21.3.50 (gnu/linux) X-AntiAbuse: This header was added to track abuse, please include it with any abuse report X-AntiAbuse: Primary Hostname - ns5.tangramltd.com X-AntiAbuse: Original Domain - gnu.org X-AntiAbuse: Originator/Caller UID/GID - [47 12] / [47 12] X-AntiAbuse: Sender Address Domain - jurta.org X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.2 Precedence: list List-Id: Emacs development discussions. List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-devel-bounces+emacs-devel=quimby.gnus.org@gnu.org Xref: main.gmane.org gmane.emacs.devel:18523 X-Report-Spam: http://spam.gmane.org/gmane.emacs.devel:18523 Luc Teirlinck writes: > Richard Stallman wrote: > > Note that nodes `Building Lists' and > `Creating Strings' are very large, so user must spend a significant > amount of time to locate this place. > > When a node is so large that it is a pain to find something in it, > we should try to split it up. Would someone like to try to split these? > > I will take a look at those two. However these two are not even the > largest nodes in the Elisp manual. `Creating Strings' has 204 lines, > `Building Lists' 252 lines. Many sections have more than 204 and a > few have more than 252. For instance, `Window frame parameters' has > 338 lines, `Coding Conventions' has 347. It's much more useful for users if Info nodes are split not by size but grouped by logically related topics. This helps to look over all related information at once. But it's not the case in some places. For instance, look at the Emacs Lisp Reference Manual: Node: Sets And Lists - Function: memq object list - Function: member-ignore-case object list - Function: delq object list - Function: member object list - Function: delete object sequence - Function: remove object sequence Node: Building Lists - ... - Function: remq object list - ... The function `remq' is placed in the wrong node and `member-ignore-case' in the wrong place of the same node. A better variant is the following: Node: Sets And Lists - Function: memq object list - Function: remq object list - Function: delq object list - Function: member object list - Function: member-ignore-case object list - Function: delete object sequence - Function: remove object sequence There are other possible inconsistencies, for instance, functions `assoc-ignore-case' and `assoc-ignore-representation' are described in the "Text Comparison" node, but better place would be the "Association Lists" node. -- http://www.jurta.org/emacs/