[Twisted-Python] Bugs in epydoc API docs.

Andrew Bennetts andrew-twisted at puzzling.org
Tue Oct 1 01:41:07 EDT 2002


E.g.
http://twistedmatrix.com/documents/TwistedDocs/Twisted-0.99.2/twisted.internet.protocol.Protocol.html

Note the bug starting at connectionLost's description; the HTML source
looks like this:

<a NAME="connectionLost"/>
<h3>connectionLost</h3>
<code><b>connectionLost(self, reason=<twisted.python.failure.Failure twisted.internet.error.Co...)</B></code><p>

Which is obviously not quite right... it leads to the rest of the page being bolded.

Also, in 0.99.2alpha3's docs (sorry, no link for you, just looking in the docs
in moshez's debian package), in twisted.internet.protocol.html, this line is
rendered without a hyperlink:

   Maintainer: U{Itamar Shtull-Trauring<mailto:twisted at itamarst.org>}

Is this a bug in epydoc, or Twisted's use of epydoc?

-Andrew.





More information about the Twisted-Python mailing list