Add doc for new doc field syntax.

This commit is contained in:
Georg Brandl 2010-01-17 19:05:19 +01:00
parent 206484ce07
commit 1a7403bed8

View File

@ -245,6 +245,8 @@ Info field lists
.. versionadded:: 0.4 .. versionadded:: 0.4
.. XXX this is only for Python
Inside object description directives, reST field lists with these fields are Inside object description directives, reST field lists with these fields are
recognized and formatted nicely: recognized and formatted nicely:
@ -272,6 +274,11 @@ explained by an example::
:type limit: integer or None :type limit: integer or None
:rtype: list of strings :rtype: list of strings
It is also possible to combine parameter type and description, if the type is a
single word, like this::
:param integer limit: maximum number of stack frames to show
This will render like this: This will render like this:
.. function:: format_exception(etype, value, tb[, limit=None]) .. function:: format_exception(etype, value, tb[, limit=None])