[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/