emacs-devel
[Top][All Lists]
Advanced

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

Re: INFO on add-ons


From: Eli Zaretskii
Subject: Re: INFO on add-ons
Date: Wed, 4 Sep 2002 06:47:32 +0200 (IST)

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).




reply via email to

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