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

[Oliver Scholz]

"Stefan Monnier" <monnier+gnu/emacs/address@hidden> writes:

>> > That is a really nice idea.  However, editing Texinfo as comments in
>> > emacs-lisp-mode doesn't appeal to me.  :-(
>> We could use a simple markup language that makes sense for plain
>
> Do you really mean "let's reinvent the wheel one more time" ?
> Texinfo is pretty "light in annotations" already, so I think
> the only thing that might be needed is some support in elisp-mode
> so you can edit the Texinfo part without comments (and in
> texinfo-mode).
[...]

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.

What I suggest is to choose a markup language in a way that a casual
reader wouldn't even notice that there is something more than "plain
text formatting" behind it. I like Texinfo and it is a convenient
format when writing documents of a certain length or a certain
complexity, but it is not an output format and I'd expect that the
"Info:" section is frequently read outside of `C-h i'. Especially for
packages that are distributed outside of Emacs.

    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