[wingide-users] RE: What doc tool do you use?
taylor234 at comcast.net
Wed Oct 5 09:12:05 MDT 2011
Thanks, Jason. You answered the right question. The shorter version is, "If
not epydoc, then what?" As I look around at other forums, I'm seeing a lot
of movement toward Sphinx.
Stephan & John, it would be good to know your thoughts on whether you could
support Sphinx (instead of or in addition to epydoc) for its interface
definitions (parameter types, return values, etc.)
From: Jason L Connor [mailto:jconnor at redhat.com]
Sent: Tuesday, October 04, 2011 3:49 PM
To: David Taylor
Cc: wingide-users at wingware.com
Subject: Re: What doc tool do you use?
On Tue, 2011-10-04 at 11:52 -0700, David Taylor wrote:
> Sigh. I just checked and you're right; epydoc hasn't had a pulse since
> I know the tool still works, but I hate the idea with adopting
> something that has no future. Does anyone have a suggestion as to
> which way to go in terms of an API-docstring doc generator that works
> well with Wing?
> From what
> 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'm not sure what it is you're looking for here.
I actually use pydoc for my current work project. However, I've been using
sphinx on some of my personal projects with great success. Plus restructured
text (read: sphinx) in compatible with rtfd.org
(readthedocs.org) as well as github :)
Jason L Connor
linear on freenode #pulp
GPG Fingerprint: 2048R/CC4ED7C1
More information about the wingide-users