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

[Goodger, David]

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
        3.14159265359

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

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.

/DG