[Twisted-Python] possible doc error

Stephen Waterbury golux at comcast.net
Sat Dec 6 23:33:41 EST 2003


Thanks, Jp -- actually, I saw them and sent my "oops"
message *just* before yours hit the list ... ;)

Yep, the API docs are definitely more explicit ...
and now I see how the docstrings for the classes were
generated, too, so that's what epydoc used.  Moshe
is pretty slick.  :)

Actually, what really would have helped would be
if the twisted.application.internet in the howto
was a link to that part of the API doc.

Jp Calderone wrote:
> On Sat, Dec 06, 2003 at 09:06:20PM -0500, Stephen Waterbury wrote:
> 
>>In howto/application:
>>
>>"It is, of course, possible to write one's own services, but Twisted 
>>comes out of the box with several services which are useful in writing 
>>network applications. Those are in twisted.application.internet."
>>
>>For sure, Twisted comes out of the box with a load of stuff,
>>but the only service I see in twisted.application.internet
>>is the TimerService.  Should that be twisted.internet.app ?
>>
> 
> 
>   Hey Steve,
> 
>     twisted.application.internet actually provides quite a few other
> services, but they are all generated in a rather unorthodox manner rather
> than defined directly, which makes finding them by reading the source a bit
> difficult.
> 
>     The automatically generated API docs are a little more informative:
> 
>   http://twistedmatrix.com/documents/TwistedDocs/current/api/twisted.application.internet.html
> 
>     Jp






More information about the Twisted-Python mailing list