Suggestions for documentation generation?
bpeng at rice.edu
Sun Mar 5 00:30:27 CET 2006
> I have written a C++ library that I've then wrapped with Pyrex.
> Any suggestions to the best-in-class tool to create documentation for
> the libraries?
> I would love to document things in one spot (could be the code) and
> generate html and PDF from there.
> Doxygen (www.doxygen.org) looks to be about the best so far.
I was facing the same problem and took the following approach:
1. write c++ code with doxygen-complaint comments
2. generate XML comments using doxygen
3. parse XML and generate Python docstring
4. insert the docstring into SWIG interface file
I can send you the parser but I do not know if pyrex support python
More information about the Python-list