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

[David Taylor]

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
diagrams...


-----Original Message-----
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
    :rtype: str
    """
--
Jason L Connor
linear on freenode #pulp
http://pulpproject.org/
RHCE: 805010912355231
GPG Fingerprint: 2048R/CC4ED7C1