[Doc-SIG] reST block quotes
David Goodger
goodger@python.org
Sun, 15 Dec 2002 23:51:33 -0500
[Beni Cherniavsky]
>> About email reading, also note that ">>> " becomes ambiguos between
>> doctest blocks and some email clients that compact nested "> "
>> quoting by omiting the spaces.
[fantasai wrote]
> Yes, that is true. That means either quoted blocks would
> have to be implemented as an option, defaulting to 'off'
> for backwards-compatability, or at least one space must
> be required between quote characters.
The Email Reader would probably have to disable doctest blocks unless
explicitly requested.
> Requiring at least one space before the quote character
> might not be a bad idea. It improves readability IMO.
Obvious from your message ;). My emailer doesn't do it that way
though and it would be onerous to require it.
> Come to think of it, the current syntax can't really
> handle nested blockquotes well, can it? Not if there's
> a quote at the beginning of another quote.
Try it; works fine.
--
David Goodger <goodger@python.org> Open-source projects:
- Python Docutils: http://docutils.sourceforge.net/
(includes reStructuredText: http://docutils.sf.net/rst.html)
- The Go Tools Project: http://gotools.sourceforge.net/