Problem using epydoc with python2.4 and restructured text

[Yuan HOng]

I wish to document my project written in python2.4 with restructured
text syntax. From the various python documentation tools it seems only
epydoc supports rst as the documentation format.

It seems however that epydoc, the last version being 2.1 released in
2004, doesn't support python2.4 well. I tried on the file example
statemachine.py given on docutils.sourceforge.net, and below is the
result:

rhodium:~# epydoc --docformat restructuredtext statemachine.py
Importing 1 modules.
 [.]
Building API documentation for 1 modules.
 [.]
/usr/lib/python2.4/site-packages/epydoc/markup/restructuredtext.py:174:
DeprecationWarning: docutils.utils.Reporter.set_conditions deprecated;
set attributes via configuration settings or directly
 document.reporter.set_conditions('', 10000, 10000, None)
===========================================================================
/root/statemachine.py
In statemachine docstring (line 7):
---------------------------------------------------------------------------
    - Error: Internal error: 'int' object is not callable

===========================================================================
/root/statemachine.py
In statemachine.string2lines docstring (line 1459):
---------------------------------------------------------------------------
    - Error: Internal error: 'int' object is not callable

===========================================================================
/root/statemachine.py
In statemachine._exception_data docstring (line 1478):
---------------------------------------------------------------------------
    - Error: Internal error: 'int' object is not callable



--
Hong Yuan

大管家网上建材超市
装修装潢建材一站式购物
http://www.homemaster.cn