[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: |
Oliver Scholz |
Subject: |
Re: Spell checking of the commentary section by checkdoc.el. |
Date: |
Fri, 16 May 2003 11:47:04 +0200 |
User-agent: |
Gnus/5.090019 (Oort Gnus v0.19) Emacs/21.3.50 (windows-nt) |
"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
- Spell checking of the commentary section by checkdoc.el., Lute Kamstra, 2003/05/12
- Re[1]: Spell checking of the commentary section by checkdoc.el., Eric M. Ludlam, 2003/05/13
- Re: Re[1]: Spell checking of the commentary section by checkdoc.el., Stefan Monnier, 2003/05/13
- Re: Spell checking of the commentary section by checkdoc.el., Lute Kamstra, 2003/05/14
- Re: Spell checking of the commentary section by checkdoc.el., Stefan Monnier, 2003/05/14
- Re: Spell checking of the commentary section by checkdoc.el., Lute Kamstra, 2003/05/15
- Re: Spell checking of the commentary section by checkdoc.el., Oliver Scholz, 2003/05/15
- Re: Spell checking of the commentary section by checkdoc.el., Stefan Monnier, 2003/05/15
- Re: Spell checking of the commentary section by checkdoc.el., Miles Bader, 2003/05/15
- Re: Spell checking of the commentary section by checkdoc.el.,
Oliver Scholz <=
- 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