.. $Id: todo.rst 1027 2012-07-16 04:41:05Z jemian $

.. _todo:

=============
TO-DO List
=============

* add support to document SPEC array declarations
* improve the display of directives for variables and macros
* make the Index look better
* provide links from each macro to its source code
* provide for the directive options indicated in the source code
* resolve the items marked *FIXME:* in the source code
* resolve the items marked *TODO:* in the source code
* identify and document undeclared variables in the global scope
* support the :summary: role to explicitly declare a summary
* cdef argument list not handled yet 
* Option to index all symbols in a macro file
* allow section headings inside macro declaration docstrings
* create a role (or example using a ref) to refer to a macro file from the documentation
* produce a custom module index with links and summary lines