#99 Additional Directives in RST

[Anonymous]

EPytext has a luscious set of directive-like tags. Specically @note and @todo.

Because I'm also using Sphinx, I'm switching to a docformat of RST. Which doesn't seem to have all the same directives.

There are two specific directives which are essential:

- a ``.. todo::`` directive would mean that my epydoc TODO list matched my sphinx todo list for those few modules which are referenced directly by Sphinx.

- a ``.. note::`` directive to create a proper admonition paragraph.

[Edward Loper]

ReST has all the same fields that epytext does; but you don't access them with directives. Instead, you use field lists [1]. E.g.:

:todo: This is a todo item.
:todo 3.2: This is a todo item with a version.
:note: This is a note item.
:param x: This is a description of parameter x.

See [2] for more info, including a complete list of directives.

[1] http://docutils.sourceforge.net/docs/ref/rst/restructuredtext.html
[2] http://epydoc.sourceforge.net/manual-fields.html

(Unfortunately, you're not logged in, so I'm not sure whether you'll see this response. I'm marking the bug report as pending; which means it will be auto-closed in 14 days.)

[SourceForge Robot]

This Tracker item was closed automatically by the system. It was
previously set to a Pending status, and the original submitter
did not respond within 14 days (the time period specified by
the administrator of this Tracker).