[Zope-dev] [Checkins] SVN: zope.app.generations/trunk/src/zope/app/generations/README.txt made blocks consistent

[Zvezdan Petkovic]

> On Mon, Apr 6, 2009 at 11:47 AM, Baiju M <mbaiju at zeomega.net> wrote:
>>
>> Why we cannot use literal blocks for source code ?
>>> From the above documentations, I can see that it works for doctest.
>> And we have used it in many places.  Also in PyPI
>> (long_description), it looks better.

Because reST specification says that they are not doctests any more if  
you use ::.  They are literal blocks in that case.

http://docutils.sourceforge.net/docs/ref/rst/restructuredtext.html#doctest-blocks

Specifically the sentence: "If both are present, the literal block  
syntax takes priority over Doctest block syntax"