[Doc-SIG] docstring grammar
Fred L. Drake, Jr.
Thu, 2 Dec 1999 17:58:14 -0500 (EST)
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.
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 L. Drake, Jr. <firstname.lastname@example.org>
Corporation for National Research Initiatives