[wingide-users] epydoc!

Michael Foord michael at voidspace.org.uk
Wed Oct 5 06:25:24 MDT 2011


On 04/10/2011 17:53, Jason L Connor wrote:
> 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.

Last time I used it the generated html for source files was horribly 
mangled and I'm pretty sure there have been no new releases since.
>
>> 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
>      """
>

I would be very happy to see Wing support the sphinx annotations.

Michael

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


-- 
http://www.voidspace.org.uk/

May you do good and not evil
May you find forgiveness for yourself and forgive others
May you share freely, never taking more than you give.
-- the sqlite blessing http://www.sqlite.org/different.html

-------------- next part --------------
An HTML attachment was scrubbed...
URL: /pipermail/wingide-users/attachments/20111005/13aa43ea/attachment.html


More information about the wingide-users mailing list