[Doc-SIG] using the same delimiter on the left and right..

Goodger, David dgoodger@atsautomation.com
Fri, 30 Mar 2001 09:57:34 -0500

Tony J Ibbs (Tibs) wrote:
> Goodger, David (?) wrote:
> > we don't
> > need all four of (inline, block) x (alien text, Python code);
> > I think that's up to the tool to deal with.
> NB: it's *not* "Python code" blocks - it's "doctest" blocks 

So use the doctest-standard '>>> ' to start a literal block, such as::

    Here's an example::

        >>> import math
        >>> print math.pi

Doctest won't care about the context (the '::' preceeding the doctest

I don't see the win in having both 'inline alien text' and 'inline Python
code'. The ugliness of the '#print "this is inline Python code"#' syntax far
outweighs its usefulness, IMO.