From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Juri Linkov Newsgroups: gmane.emacs.devel Subject: Re: info.texi Date: Thu, 11 Aug 2005 03:29:33 +0300 Organization: JURTA Message-ID: <87y879789s.fsf@jurta.org> References: <200508101355.j7ADtjp25568@tug.org> NNTP-Posting-Host: main.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Trace: sea.gmane.org 1123722029 18988 80.91.229.2 (11 Aug 2005 01:00:29 GMT) X-Complaints-To: usenet@sea.gmane.org NNTP-Posting-Date: Thu, 11 Aug 2005 01:00:29 +0000 (UTC) Cc: emacs-devel@gnu.org Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Thu Aug 11 03:00:27 2005 Return-path: Original-Received: from lists.gnu.org ([199.232.76.165]) by ciao.gmane.org with esmtp (Exim 4.43) id 1E31Q1-0002fK-69 for ged-emacs-devel@m.gmane.org; Thu, 11 Aug 2005 02:59:37 +0200 Original-Received: from localhost ([127.0.0.1] helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1E31T9-0000tJ-PV for ged-emacs-devel@m.gmane.org; Wed, 10 Aug 2005 21:02:51 -0400 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1E31RN-0000IL-4V for emacs-devel@gnu.org; Wed, 10 Aug 2005 21:01:01 -0400 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1E31RH-0000EH-4V for emacs-devel@gnu.org; Wed, 10 Aug 2005 21:00:56 -0400 Original-Received: from [199.232.76.173] (helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1E31RF-00006q-Ms for emacs-devel@gnu.org; Wed, 10 Aug 2005 21:00:53 -0400 Original-Received: from [194.126.101.111] (helo=mail.neti.ee) by monty-python.gnu.org with esmtp (Exim 4.34) id 1E31QN-00045k-0y for emacs-devel@gnu.org; Wed, 10 Aug 2005 20:59:59 -0400 Original-Received: from mail.neti.ee (80-235-36-62-dsl.mus.estpak.ee [80.235.36.62]) by Relayhost1.neti.ee (Postfix) with ESMTP id 663C61AAC; Thu, 11 Aug 2005 03:45:19 +0300 (EEST) Original-To: karl@freefriends.org (Karl Berry) In-Reply-To: <200508101355.j7ADtjp25568@tug.org> (Karl Berry's message of "Wed, 10 Aug 2005 15:55:45 +0200") User-Agent: Gnus/5.110004 (No Gnus v0.4) Emacs/22.0.50 (gnu/linux) X-Virus-Scanned: by amavisd-new-2.2.1 (20041222) (Debian) at neti.ee 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:41894 X-Report-Spam: http://spam.gmane.org/gmane.emacs.devel:41894 > The new node tree has three top nodes: `Getting Started' for novices, > `Advanced' for advances users, and `Expert Info' with the description > of Info internals. > > In general this sounds quite good to me. The current conglomeration has > always struck me as less than ideal. > > Two thoughts: > > - "edit document" seems "expert" to me. The item `Info-enable-edit' in the node `Emacs Info Variables' has a cross-reference @xref{Add, Edit}. It seems it tries to refer to the text describing the command `e' which is currently located in the node `Advanced'. So either this text should be moved to the node `Add', or to a new node `Edit' under `Expert Info'. > - the search commands seem by far the most important to me. In fact, > they are the primary feature that (still) distinguishes Info from HTML > etc. So I would put them first in the Advanced chapter. I also > suggest putting Search Text before Search Index. Ok, a new node tree is below. I will create a patch in a few days if no one has more suggestions. Getting Started Help-Small-Screen Help Help-P Help-^L Help-Inv Help-] Help-] Help-] Help-M Help-FOO Help-FOO Help-FOO Help-Xref Help-Int Help-Q Advanced Search Text Search Index Go to node Choose menu subtopic Create Info buffer Emacs Info Variables Expert Info Edit Add Menus Cross-refs Help-Cross Tags Checking Creating an Info File Index -- Juri Linkov http://www.jurta.org/emacs/