On Fri, Aug 29, 2008 at 5:36 AM, Chris Withers <chris@simplistix.co.uk> wrote:
Benji York wrote:
On Mon, Aug 25, 2008 at 6:24 AM, Michael Howitz <mh@gocept.com> wrote:
Log message for revision 90184: made doctest sections from the literal sections
Thanks for removing the unneccesary -- and inappropriate
Why are they unneccesary and inappropriate?
The double-colons are structural markup, they signify the introduction of a literal block (http://docutils.sourceforge.net/docs/user/rst/quickref.html#literal-blocks). doctest blocks have their own syntax (http://docutils.sourceforge.net/docs/user/rst/quickref.html#doctest-blocks).
These are what causes the examples to appear in blue boxes on PyPI, which I think makes them much clearer...
That's a matter of presentation, not structure. If you would like to see a change to the way doctest blocks are formatted on PyPI, you should make a proposal to the PyPI folks. -- Benji York Senior Software Engineer Zope Corporation