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

2001年3月30日 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
 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