[Doc-SIG] syntax vs semantics: implicit --> explicit

[Goodger, David]

> How important is it that those mini-man pages are readable as part of
> the source?

In the case of the man-pages, not terribly. They could be in a separate
file. I guess I'm a proponent of the "keep it all together" school. One of
the advantages of docstrings: they're *there*, easily accessible, no
dependency on possibly nonexistant external files and all those headaches.

> I'm trying to argue for a smaller set of requirements, so we can make
> progress.

You've convinced me. I hope to spend a few hours over the next week or so
revising my spec, maybe even turning it into a PEP (to complement/compete
with Tibs' & Edward L's work). Watch this space...

> Sounds like a stretch to blame it on Word.

Such an easy target!

/DG