Re: Spell checking of the commentary section by checkdoc.el.

[Oliver Scholz]

Richard Stallman <address@hidden> writes:

>     FYI: I realize now that this is already in etc/TODO:
>
>     | * Replace finder.el with something that generates an Info file
>     |   which gives the same information through a menu structure.  [Dave
>     |   Love started on this.]
>
> I don't think it is the same thing.  There is definitely a similarity,
> but also an important difference.  This is a more convenient interface
> to browse the list of packages; it is not an attempt to put parts of
> manuals into source files.

Well, currently there are many packages which have the bigger part of
their documentation -- or even their only documentation -- in the
commentary section of their source files. So currently the only
interface that provides documentation for many small libraries is
`finder-by-keyword' resp. `finder-commentary'. I took it for granted
that this is the raison d'être of finder.el.

I think, what we are talking about is separating documentation for
end-users from implementation notes in those commentary sections and
putting the former into a new "Info:" section.

    Oliver
-- 
Oliver Scholz               29 Floréal an 211 de la Révolution
Taunusstr. 25               Liberté, Egalité, Fraternité!
60329 Frankfurt a. M.       http://www.jungdemokratenhessen.de
Tel. (069) 97 40 99 42      http://www.jdjl.org