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

[Stefan Monnier]

>     PS: By the way, I think we should introduce a new section whose
>       content is Texinfo prefixed with `;; ', and we should then
>       automatically build an "Emacs Packages Manuals" info page
>       (separate from the emacs manual) that holds the doc of all
>       those packages.
> 
> I think this is generally a bad idea, for several reasons.
> One of them is that we want to put the manual text under the GFDL.

I didn't think of that, but you're correct that it would prevent
package authors from publishing their doc under the GFDL using
this scheme.  OTOH, I mostly think of this Texinfo section as a
replacement for the `Commentary' section, so it wouldn't make that
much of a difference.  The main benefit is that you can format
the output much better, with indices, cross links and whatnot.

> Aside from that, it would be cleaner to keep extensive tracts
> of documentation in separate files.

I don't intend to use it as a replacement for separate manuals.
That would indeed be a bad idea.  I'm thinking more along the lines
of "small packages currently not documented in the manual" or
"packages distributed separately from Emacs as single .el files".


        Stefan