emacs-devel
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: info.texi


From: Juri Linkov
Subject: Re: info.texi
Date: Thu, 11 Aug 2005 03:29:33 +0300
User-agent: Gnus/5.110004 (No Gnus v0.4) Emacs/22.0.50 (gnu/linux)

>     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/





reply via email to

[Prev in Thread] Current Thread [Next in Thread]