[wingide-users] What doc tool do you use?
taylor234 at comcast.net
Tue Oct 4 12:52:47 MDT 2011
Sigh. I just checked and you're right; epydoc hasn't had a pulse since 2008.
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
From: wingide-users-bounces at wingware.com
[mailto:wingide-users-bounces at wingware.com] On Behalf Of Jason L Connor
Sent: Tuesday, October 04, 2011 9:54 AM
To: wingide-users at wingware.com
Subject: Re: [wingide-users] epydoc!
On Tue, 2011-10-04 at 17:32 +0100, Michael Foord wrote:
> Although epydoc itself is dead, right? (No longer maintained and
> pretty serious bugs in the output from the last released version.)
I don't really think there are serious bugs in it. I'm not sure if it's
still maintained or not. Personally I use it all the time.
> Does sphinx, along with its autodoc extensions, have any convention
> around parameter types and return values?
It does. In it's python domain it also uses the type and rtype
documentation. For example:
def my_func(arg1, arg2):
:param arg1: first argument
:type arg1: int
Jason L Connor
linear on freenode #pulp
GPG Fingerprint: 2048R/CC4ED7C1
More information about the wingide-users