On Fri, Aug 29, 2008 at 5:36 AM, Chris Withers <[EMAIL PROTECTED]> wrote:
> Benji York wrote:
>>
>> On Mon, Aug 25, 2008 at 6:24 AM, Michael Howitz <[EMAIL PROTECTED]> 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
_______________________________________________
Zope-Dev maillist  -  Zope-Dev@zope.org
http://mail.zope.org/mailman/listinfo/zope-dev
**  No cross posts or HTML encoding!  **
(Related lists - 
 http://mail.zope.org/mailman/listinfo/zope-announce
 http://mail.zope.org/mailman/listinfo/zope )

Reply via email to