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

[Stefan Monnier]

> I don't think it's reinventing the wheel. The same principle has been
> applied and explored by various Wikis on the Web and elsewhere,
> including http://www.emacswiki.org and emacs-wiki.el. They use a
> similar kind of markup like the one I described, because they regard
> it as more convenient than writing HTML directly. bhl.el follows a
> similar principle: write plain text in a simple markup and convert it
> to LaTeX, HTML or SGML.

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.

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.


        Stefan