On Mon, Apr 6, 2009 at 11:56 AM, Benji York <benji@zope.com> wrote:
On Mon, Apr 6, 2009 at 11:47 AM, Baiju M <mbaiju@zeomega.net> wrote:
On Mon, Apr 6, 2009 at 12:46 AM, Michael Howitz <mh@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-b... [2] http://docutils.sourceforge.net/docs/ref/rst/restructuredtext.html#doctest-b...
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