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.devel,gmane.emacs.xemacs.design
Subject: Re: INFO on add-ons
Date: Wed, 4 Sep 2002 06:47:32 +0200 (IST)
Sender: emacs-devel-admin@gnu.org
Message-ID: <Pine.SUN.3.91.1020904064513.27231D@is>
References: <buo4rd6mt2e.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 1031115021 2312 127.0.0.1 (4 Sep 2002 04:50:21 GMT)
X-Complaints-To: usenet@main.gmane.org
NNTP-Posting-Date: Wed, 4 Sep 2002 04:50:21 +0000 (UTC)
Cc: emacs-devel@gnu.org, xemacs-design@xemacs.org
Return-path: <emacs-devel-admin@gnu.org>
Original-Received: from quimby.gnus.org ([80.91.224.244])
	by main.gmane.org with esmtp (Exim 3.35 #1 (Debian))
	id 17mS7P-0000bA-00
	for <emacs-devel@main.gmane.org>; Wed, 04 Sep 2002 06:50:19 +0200
Original-Received: from monty-python.gnu.org ([199.232.76.173])
	by quimby.gnus.org with esmtp (Exim 3.12 #1 (Debian))
	id 17mSgR-00045L-00
	for <emacs-devel@quimby.gnus.org>; Wed, 04 Sep 2002 07:26:31 +0200
Original-Received: from localhost ([127.0.0.1] helo=monty-python.gnu.org)
	by monty-python.gnu.org with esmtp (Exim 4.10)
	id 17mS8z-00050Z-00; Wed, 04 Sep 2002 00:51:57 -0400
Original-Received: from list by monty-python.gnu.org with tmda-scanned (Exim 4.10)
	id 17mS7M-0004ps-00
	for emacs-devel@gnu.org; Wed, 04 Sep 2002 00:50:16 -0400
Original-Received: from mail by monty-python.gnu.org with spam-scanned (Exim 4.10)
	id 17mS7F-0004pa-00
	for emacs-devel@gnu.org; Wed, 04 Sep 2002 00:50:15 -0400
Original-Received: from is.elta.co.il ([199.203.121.2])
	by monty-python.gnu.org with esmtp (Exim 4.10)
	id 17mS7E-0004p9-00; Wed, 04 Sep 2002 00:50:09 -0400
Original-Received: from is (is [199.203.121.2])
	by is.elta.co.il (8.9.3/8.8.8) with SMTP id GAA27346;
	Wed, 4 Sep 2002 06:47:32 +0200 (IST)
X-Sender: eliz@is
Original-To: Miles Bader <miles@gnu.org>
In-Reply-To: <buo4rd6mt2e.fsf@mcspd15.ucom.lsi.nec.co.jp>
Errors-To: emacs-devel-admin@gnu.org
X-BeenThere: emacs-devel@gnu.org
X-Mailman-Version: 2.0.11
Precedence: bulk
List-Help: <mailto:emacs-devel-request@gnu.org?subject=help>
List-Post: <mailto:emacs-devel@gnu.org>
List-Subscribe: <http://mail.gnu.org/mailman/listinfo/emacs-devel>,
	<mailto:emacs-devel-request@gnu.org?subject=subscribe>
List-Id: Emacs development discussions. <emacs-devel.gnu.org>
List-Unsubscribe: <http://mail.gnu.org/mailman/listinfo/emacs-devel>,
	<mailto:emacs-devel-request@gnu.org?subject=unsubscribe>
List-Archive: <http://mail.gnu.org/pipermail/emacs-devel/>
Xref: main.gmane.org gmane.emacs.devel:7432 gmane.emacs.xemacs.design:1375
X-Report-Spam: http://spam.gmane.org/gmane.emacs.devel:7432


On 4 Sep 2002, Miles Bader wrote:

> Usually when I write manual entries I mostly copy the doc-strings I
> wrote earlier, make mechanical changes like replacing FOO with
> @var{foo}, and change the wording slightly to fit the manual format
> better (e.g., remove duplicate text that can be shared more easily in
> the manual page).
> 
> 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).