[Zope-dev] [Checkins] SVN: zc.recipe.testrunner/trunk/src/zc/recipe/testrunner/README.txt made doctest sections from the literal sections

[Benji York]

On Fri, Aug 29, 2008 at 5:36 AM, Chris Withers <chris at simplistix.co.uk> wrote:
> Benji York wrote:
>>
>> On Mon, Aug 25, 2008 at 6:24 AM, Michael Howitz <mh at 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