[Doc-SIG] field syntax (was re: lists & blank lines)
Goodger, David
dgoodger@atsautomation.com
Mon, 16 Apr 2001 14:12:33 -0400
[Edward Loper]
> @param x: ...
I'm not a big fan of the JavaDoc @ syntax, but I don't know of a better
inline syntax for keyword-tagged values. (I did propose a [directive-based
syntax]_; search for "keyword".) I propose that until a clearly superior
syntax is discovered/revealed, we leave these out of the discussion
(unnecessary complication).
/DG
.. _directive-based syntax:
http://mail.python.org/pipermail/doc-sig/2000-November/001241.html