[Doc-SIG] docstring grammar

Jack Jansen jack@oratrix.nl
Mon, 29 Nov 1999 10:41:38 +0100

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