Suggestions for documentation generation?

[John M. Gabriele]

kpd wrote:
> Hello,
> 
> 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. 
> 
> Thanks,
> 

I've heard that some folks use pythondoc:
http://starship.python.net/crew/danilo/pythondoc/
http://effbot.org/zone/pythondoc.htm

There's also HappyDoc http://happydoc.sourceforge.net/
and EpyDoc http://epydoc.sourceforge.net/ .

-- 
(remove zeez if demunging email address)