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

Benji York benji at zope.com
Mon Apr 6 12:56:29 EDT 2009


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

(adding zope-dev and removing checkins)
--
Benji York
Senior Software Engineer
Zope Corporation


More information about the Zope-Dev mailing list