From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: "Robert J. Chassell" Newsgroups: gmane.emacs.devel,gmane.mail.mh-e.devel Subject: Re: MH-E manual update Date: Sun, 12 Mar 2006 11:59:06 +0000 (UTC) Message-ID: References: <27306.1134088031@olgas.newt.com> <871wxfnisy.fsf@olgas.newt.com> <9353.1142107690@olgas.newt.com> <13900.1142119921@olgas.newt.com> Reply-To: bob@rattlesnake.com NNTP-Posting-Host: main.gmane.org X-Trace: sea.gmane.org 1142195335 2431 80.91.229.2 (12 Mar 2006 20:28:55 GMT) X-Complaints-To: usenet@sea.gmane.org NNTP-Posting-Date: Sun, 12 Mar 2006 20:28:55 +0000 (UTC) Cc: mh-e-devel@lists.sourceforge.net, emacs-devel@gnu.org Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Sun Mar 12 21:28:50 2006 Return-path: Envelope-to: ged-emacs-devel@m.gmane.org Original-Received: from lists.gnu.org ([199.232.76.165]) by ciao.gmane.org with esmtp (Exim 4.43) id 1FIWSs-0006bJ-EH for ged-emacs-devel@m.gmane.org; Sun, 12 Mar 2006 20:43:01 +0100 Original-Received: from localhost ([127.0.0.1] helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1FIWSs-0003uq-0O for ged-emacs-devel@m.gmane.org; Sun, 12 Mar 2006 14:42:54 -0500 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1FIPEG-0006qX-2F for emacs-devel@gnu.org; Sun, 12 Mar 2006 06:59:20 -0500 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1FIPEF-0006qJ-Aa for emacs-devel@gnu.org; Sun, 12 Mar 2006 06:59:19 -0500 Original-Received: from [199.232.76.173] (helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1FIPEF-0006qG-5e for emacs-devel@gnu.org; Sun, 12 Mar 2006 06:59:19 -0500 Original-Received: from [69.168.108.225] (helo=rattlesnake.com) by monty-python.gnu.org with esmtp (Exim 4.52) id 1FIPHy-0005xa-N5 for emacs-devel@gnu.org; Sun, 12 Mar 2006 07:03:10 -0500 Original-Received: by rattlesnake.com via sendmail from stdin id (Debian Smail3.2.0.115) Sun, 12 Mar 2006 11:59:06 +0000 (UTC) Original-To: Bill Wohler In-reply-to: <13900.1142119921@olgas.newt.com> (message from Bill Wohler on Sat, 11 Mar 2006 15:32:01 -0800) 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:51531 gmane.mail.mh-e.devel:11958 Archived-At: 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