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
-- http://mail.python.org/mailman/listinfo/python-list