[wingide-users] RE: What doc tool do you use?

[David Taylor]

Thanks Richard. That's what I wanted to know and *then* some. Having a
script to automatically gather up all the current packages is icing on the
cake.  

-----Original Message-----
From: wingide-users-bounces at wingware.com
[mailto:wingide-users-bounces at wingware.com] On Behalf Of Richard Shea
Sent: Wednesday, October 05, 2011 4:42 PM
To: wingide-users at wingware.com; wingide-users at wingware.com
Subject: [wingide-users] RE: What doc tool do you use?


> I can see with a quick search, Sphinx seems to be alive and well, and 
> getting the most attention. Any feedback on it? All I need is a 
> lightweight tool, though I had hoped to use pydoc with GraphViz to 
> produce UML diagrams...
> 
I use sphinx very happily. 

The 'autodoc' extension is really (for me) the guts of it. 

In addition there's a project of Etienne Desautels ...

https://bitbucket.org/etienned/sphinx-autopackage-script/overview 

... which is really useful (well done Etienne) and makes 'autodoc'
easier to use. 

I've written some stuff about how to use that script if you find any
difficulties with it ...

http://mainlydata.kubadev.com/python/sphinx-how-to-make-autodoc-really-autom
atic/


regards

Richard.

_________________________________________________
Wing IDE users list
http://wingware.com/lists/wingide