[Doc-SIG] docstring grammar

[Jack Jansen]

Now I'm getting confused. Confused about what the intention of
docstrings is, that is: as I see them they're quick-reference
documentation to be used by IDE's and class browsers and such to help
you while you're busy hacking. But more and more terms like extraction 
of docstrings and such pops up, so I'm wondering whether people are
envisioning a tangle/weave/web-like system where the full documentation is
included in the source...

And, yes, I know I happily joined in in the latter, with the
multilingual discussion and more, but I think I would definitely
prefer the former scheme, possibly even combined with
the-latter-in-reverse, where the Real Documentation was structured in
such a way that there could be tools that you would feed the
documentation and the source, and that would add docstrings to the source.
--
Jack Jansen             | ++++ stop the execution of Mumia Abu-Jamal ++++
Jack.Jansen@oratrix.com | ++++ if you agree copy these lines to your sig ++++
www.oratrix.nl/~jack    | see http://www.xs4all.nl/~tank/spg-l/sigaction.htm