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