[Top][All Lists]
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: Spell checking of the commentary section by checkdoc.el.
From: |
Stefan Monnier |
Subject: |
Re: Spell checking of the commentary section by checkdoc.el. |
Date: |
Fri, 16 May 2003 13:43:28 -0400 |
> 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
- Re: Spell checking of the commentary section by checkdoc.el., (continued)
- Re: Spell checking of the commentary section by checkdoc.el., Stefan Monnier, 2003/05/16
- Re: Spell checking of the commentary section by checkdoc.el., Oliver Scholz, 2003/05/16
- Re: Spell checking of the commentary section by checkdoc.el., Stefan Monnier, 2003/05/16
- Re: Spell checking of the commentary section by checkdoc.el., Eli Zaretskii, 2003/05/17
- Re: Spell checking of the commentary section by checkdoc.el., Oliver Scholz, 2003/05/18
- Re: Spell checking of the commentary section by checkdoc.el., Eli Zaretskii, 2003/05/17
- Re: Spell checking of the commentary section by checkdoc.el., Lute Kamstra, 2003/05/22
- Re: Spell checking of the commentary section by checkdoc.el., Stefan Monnier, 2003/05/22
- Re: Spell checking of the commentary section by checkdoc.el., Lute Kamstra, 2003/05/23
- Re: Spell checking of the commentary section by checkdoc.el., Richard Stallman, 2003/05/16
- Re: Spell checking of the commentary section by checkdoc.el.,
Stefan Monnier <=
- Re: Spell checking of the commentary section by checkdoc.el., Richard Stallman, 2003/05/18
- Re: Spell checking of the commentary section by checkdoc.el., Oliver Scholz, 2003/05/16
- Re: Spell checking of the commentary section by checkdoc.el., Eli Zaretskii, 2003/05/17
- Re: Spell checking of the commentary section by checkdoc.el., Richard Stallman, 2003/05/18
- Re: Spell checking of the commentary section by checkdoc.el., Oliver Scholz, 2003/05/18
- Re: Spell checking of the commentary section by checkdoc.el., Richard Stallman, 2003/05/15