[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