[Doc-SIG] docstring grammar

[Fred L. Drake, Jr.]

David Ascher writes:
 > The only question I suppose is whether one should require a keyword (Test:
 > or other) to keep the top-level syntax trivial, or special-case the
 > recognition of >>>-beginning paragraphs.
 > 
 > I'm leaning for the former, as it can evolve to the latter if there is
 > sufficient call for it from the user base, and I think it does keep the
 > code simpler.  But I'm willing to be swayed.

  Sway.  ;-)
  I think anything that starts ">>>" or "..." should automagically be
a verbatim-thingy.  This is easy enough to implement and avoids excess 
cruft in docstrings.


  -Fred

--
Fred L. Drake, Jr.	     <fdrake@acm.org>
Corporation for National Research Initiatives