emacs-devel
[Top][All Lists]
Advanced

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

Re: MH-E manual update


From: Robert J. Chassell
Subject: Re: MH-E manual update
Date: Sun, 12 Mar 2006 11:59:06 +0000 (UTC)

    Since the audience of the MH-E user includes someone who does not
    know Emacs (see Info node (mh-e) Preface), having an index section
    that starts with Emacs, is useful since they might not remember
    the term "point" but would know that it is an Emacs' thingy.

As (texinfo)Index Entries says,

    When you are making index entries, it is good practice to think of
    the different ways people may look for something.  Different
    people _do not_ think of the same words when they look something
    up.  A helpful index will have items indexed under all the
    different words that people may use.

Please make entries both with and without the `Emacs' prefix.  People
who use `i' may be taken to the Emacs entry first.

But certainly many hardcopy readers are likely first to look under
`Emacs, mark, point, and region' although not all.  Some will look
under `mark' first.  

And, if those who use `Info-index' look for `mark', `point', or
`region', rather than `Emacs, ...', they will be taken to those
entries.

As (texinfo)Index Entries also says,

    A good index will have both entries and will help both readers.

-- 
    Robert J. Chassell                         
    address@hidden                         GnuPG Key ID: 004B4AC8
    http://www.rattlesnake.com                  http://www.teak.cc




reply via email to

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