From mboxrd@z Thu Jan  1 00:00:00 1970
Path: main.gmane.org!not-for-mail
From: Eli Zaretskii <eliz@is.elta.co.il>
Newsgroups: gmane.emacs.xemacs.design,gmane.emacs.devel
Subject: Re: INFO on add-ons
Date: Wed, 4 Sep 2002 07:06:52 +0200 (IST)
Sender: xemacs-design-admin@xemacs.org
Message-ID: <Pine.SUN.3.91.1020904070558.27231O@is>
References: <buoznuyjqjw.fsf@mcspd15.ucom.lsi.nec.co.jp>
NNTP-Posting-Host: localhost.gmane.org
Mime-Version: 1.0
Content-Type: TEXT/PLAIN; charset=US-ASCII
X-Trace: main.gmane.org 1031116118 4004 127.0.0.1 (4 Sep 2002 05:08:38 GMT)
X-Complaints-To: usenet@main.gmane.org
NNTP-Posting-Date: Wed, 4 Sep 2002 05:08:38 +0000 (UTC)
Cc: emacs-devel@gnu.org, xemacs-design@xemacs.org
Return-path: <xemacs-design-admin@xemacs.org>
Original-Received: from gwyn.tux.org ([207.96.1.200])
	by main.gmane.org with esmtp (Exim 3.35 #1 (Debian))
	id 17mSP3-000124-00
	for <xemacs-design@gmane.org>; Wed, 04 Sep 2002 07:08:34 +0200
Original-Received: from gwyn.tux.org (localhost.localdomain [127.0.0.1])
	by gwyn.tux.org (8.9.3/8.9.1) with ESMTP id BAA05802;
	Wed, 4 Sep 2002 01:10:06 -0400
Original-Received: (from turnbull@localhost)
	by gwyn.tux.org (8.9.3/8.9.1) id BAA01123
	for xemacs-design-mailman@xemacs.org; Wed, 4 Sep 2002 01:09:31 -0400
Original-Received: (from mail@localhost)
	by gwyn.tux.org (8.9.3/8.9.1) id BAA01107
	for turnbull@tux.org; Wed, 4 Sep 2002 01:09:31 -0400
Original-Received: from is.elta.co.il (is.elta.co.il [199.203.121.2])
	by gwyn.tux.org (8.9.3/8.9.1) with ESMTP id BAA00980
	for <xemacs-design@xemacs.org>; Wed, 4 Sep 2002 01:09:30 -0400
Original-Received: from is (is [199.203.121.2])
	by is.elta.co.il (8.9.3/8.8.8) with SMTP id HAA27607;
	Wed, 4 Sep 2002 07:06:52 +0200 (IST)
X-Sender: eliz@is
Original-To: Miles Bader <miles@gnu.org>
In-Reply-To: <buoznuyjqjw.fsf@mcspd15.ucom.lsi.nec.co.jp>
X-XEmacs-List: design
Errors-To: xemacs-design-admin@xemacs.org
X-BeenThere: xemacs-design@xemacs.org
X-Mailman-Version: 2.0.1
Precedence: bulk
List-Help: <mailto:xemacs-design-request@xemacs.org?subject=help>
List-Post: <mailto:xemacs-design@xemacs.org>
List-Subscribe: <http://lists.xemacs.org/lists/listinfo/xemacs-design>,
	<mailto:xemacs-design-request@xemacs.org?subject=subscribe>
List-Id: Discussion of design and features for XEmacs. <xemacs-design.xemacs.org>
List-Unsubscribe: <http://lists.xemacs.org/lists/listinfo/xemacs-design>,
	<mailto:xemacs-design-request@xemacs.org?subject=unsubscribe>
Xref: main.gmane.org gmane.emacs.xemacs.design:1377 gmane.emacs.devel:7434
X-Report-Spam: http://spam.gmane.org/gmane.emacs.devel:7434


On 4 Sep 2002, Miles Bader wrote:

> Eli Zaretskii <eliz@is.elta.co.il> writes:
> > > Perhaps what we ought to do is make it easier to produce a coherent
> > > info node(s) from a package's existing information.
> > 
> > Adding index entries is a significant task of writing a good manual.  
> > Without an index, a manual cannot be used as a reference.  Indexation is 
> > still largely a human task that cannot be easily automated (although some 
> > help here would be nice).
> 
> There's no reason why indexing command couldn't be embedded in
> doc-strings/comments.

Right.  However, my point was that coming up with the index entries is 
not a job for a program, it requires human intervention.