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

[Baiju M]

On Mon, Apr 6, 2009 at 11:56 AM, Benji York <benji at zope.com> wrote:
> On Mon, Apr 6, 2009 at 11:47 AM, Baiju M <mbaiju at zeomega.net> wrote:
>> On Mon, Apr 6, 2009 at 12:46 AM, Michael Howitz <mh at gocept.com> wrote:
>>> Am 05.04.2009 um 22:00 schrieb Baiju M:
>>>>
>>>> In reStructuredText, I think two colons "::"" is required to make it
>>>> source text ?
>>>
>>> No, double colons mark literal blocks [1].
>>> Doctest blocks are marked by ">>>" at the beginning of the line. [2]
>>>
>>> [1]
>>> http://docutils.sourceforge.net/docs/ref/rst/restructuredtext.html#literal-blocks
>>> [2]
>>> http://docutils.sourceforge.net/docs/ref/rst/restructuredtext.html#doctest-blocks
>>
>> 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.
>
> Please see http://mail.zope.org/pipermail/zope-dev/2008-August/033010.html

So we should not use either single colon (:) or indent doctest ?

Regards,
Baiju M