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

[Oliver Scholz]

"Stefan Monnier" <monnier+gnu/emacs/address@hidden> writes:
[...]
> To me, it would be "yet another markup", which we'd probably need
> to design (I doubt the wiki markups would address the needs of
> writing documentation well enough), document, and implement
> (i.e. writing a converter to Texinfo).
>
> The only benefit is that it would look a bit more like plain ascii
> and that it wouldn't be as flexible as Texinfo and would require
> more work from us.  Doesn't sound like a win to me.

My preference for a Wiki-style markup is based on the assumption that
only a small subset of Texinfo is needed here and that designing the
markup and implementing the code to convert it is straightforward. I
may be wrong with either of these two assumptions, of course, but I
don't see it yet. As for the benefit of having the "Info:" section
look like plain ascii: well, your mileage varies, obviously. :-)

Just to make sure: are we really talking about the same thing here?
What I have in mind is to generate the info manual on the fly: extract
the "Info:" section from the el-file, convert it to the format which
the info reader takes as input and display it in info-mode. I presume
that it would be significantly faster to do this with a simple markup
that supports only a subset of Texinfo. But I have no experience here,
so I may be much mistaken.

> I agree that writing HTML is generally a bit too painful, but I don't
> think Texinfo suffers in the same way, so the need for a lighterweight
> markup language is significantly reduced.
[...]

Point taken.

    Oliver
-- 
Oliver Scholz               27 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