[Doc-SIG] docstring grammar

[Jack Jansen]

Very nice proposal!

>   I chose double-colon notation for keywords so that one can have text
>   paragraphs which match the 'word:' notation without having them be
>   interpreted as keywords.

If you can get rid of this, and use single colon in stead, I would be 100% 
happy. As most of the keywords are fixed (only in the References section could 
I find user-defined keywords) this should be doable. And it would make the 
document that little bit more readable.
--
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