unofficial mirror of emacs-devel@gnu.org 
 help / color / mirror / code / Atom feed
From: "Robert J. Chassell" <bob@rattlesnake.com>
Cc: mh-e-devel@lists.sourceforge.net, emacs-devel@gnu.org
Subject: Re: MH-E manual update
Date: Sun, 12 Mar 2006 11:59:06 +0000 (UTC)	[thread overview]
Message-ID: <m1FIPE2-0004HzC@rattlesnake.com> (raw)
In-Reply-To: <13900.1142119921@olgas.newt.com> (message from Bill Wohler on Sat, 11 Mar 2006 15:32:01 -0800)

    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                         
    bob@rattlesnake.com                         GnuPG Key ID: 004B4AC8
    http://www.rattlesnake.com                  http://www.teak.cc

  reply	other threads:[~2006-03-12 11:59 UTC|newest]

Thread overview: 28+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2005-12-09  0:27 MH-E manual update Bill Wohler
2005-12-09 11:58 ` Eli Zaretskii
2005-12-09 14:40   ` Bill Wohler
2005-12-09 18:50     ` Eli Zaretskii
2005-12-09 21:15   ` Richard M. Stallman
2005-12-10  0:25     ` Bill Wohler
2005-12-10 16:18       ` Richard M. Stallman
2006-03-07  1:29 ` Bill Wohler
2006-03-11 14:30   ` Eli Zaretskii
2006-03-11 20:08     ` Bill Wohler
2006-03-11 21:35       ` Luc Teirlinck
2006-03-11 22:27         ` Bill Wohler
2006-03-11 23:08           ` Luc Teirlinck
2006-03-11 23:34             ` Bill Wohler
2006-03-11 23:24           ` Luc Teirlinck
2006-03-11 23:40             ` Bill Wohler
2006-03-11 23:39               ` Luc Teirlinck
2006-03-11 23:49                 ` Bill Wohler
2006-03-12  2:39                   ` Luc Teirlinck
2006-03-12  3:56                     ` Bill Wohler
2006-03-12  0:39               ` Luc Teirlinck
2006-03-11 22:10       ` Eli Zaretskii
2006-03-11 23:32         ` Bill Wohler
2006-03-12 11:59           ` Robert J. Chassell [this message]
2006-03-13 12:55             ` Richard Stallman
2006-03-13 15:20               ` Robert J. Chassell
2006-03-13 16:29               ` Bill Wohler
2006-03-14  4:26                 ` Eli Zaretskii

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

  List information: https://www.gnu.org/software/emacs/

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=m1FIPE2-0004HzC@rattlesnake.com \
    --to=bob@rattlesnake.com \
    --cc=emacs-devel@gnu.org \
    --cc=mh-e-devel@lists.sourceforge.net \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
Code repositories for project(s) associated with this public inbox

	https://git.savannah.gnu.org/cgit/emacs.git

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).