[Doc-SIG] using the same delimiter on the left and right..

Guido van Rossum guido@digicool.com
Thu, 29 Mar 2001 13:07:32 -0500


David Goodger writes:

>   - A Plan for Structured Text
>     http://mail.python.org/pipermail/doc-sig/2000-November/001239.html
> 
>   - Problems With StructuredText
>     http://mail.python.org/pipermail/doc-sig/2000-November/001240.html
> 
>   - reStructuredText: Revised Structured Text Specification
>     http://mail.python.org/pipermail/doc-sig/2000-November/001241.html

What I like most about this is that it is a full specification!  The
first one I've seen that's exact enough to be criticized and to be
understood.  I think you may be going overboard with features, but I
like many of your ideas, both about heuristics for implicit markup
(e.g. sections) and about the tokens you use for explicit markup
(using "..").  I also like that you define the escaping mechanism
upfront.  (Using \ to escape means that we're going to have to make
our docstrings raw strings.  Big deal. :-)

--Guido van Rossum (home page: http://www.python.org/~guido/)