Re: [Twisted-Python] glossary (was Re: Using SerialPort with t.a.s.Application)

2011-01-29 Thread Glyph Lefkowitz
On Jan 28, 2011, at 10:51 PM, Kevin Horn wrote: > right now the API docs aren't a lot of help for older code, and most of the > core things are older code. And that's exactly the problem - I don't want to paper that over with a shiny new project to explain everything in some new location. I wa

Re: [Twisted-Python] glossary (was Re: Using SerialPort with t.a.s.Application)

2011-01-28 Thread Kevin Horn
> > > I'm not sure how much of a problem maintaining it would be, especially as I > agree that linking to the API docs is probably a good idea (though I think a > lot of the docstrings in there could be greatly improved). For one thing, > how often has the _intent_ of the IProtocol interface(which

Re: [Twisted-Python] glossary (was Re: Using SerialPort with t.a.s.Application)

2011-01-28 Thread Kevin Horn
On Fri, Jan 28, 2011 at 7:50 PM, Glyph Lefkowitz wrote: > > On Jan 28, 2011, at 5:47 PM, Kevin Horn wrote: > > > > On Fri, Jan 28, 2011 at 1:33 PM, Glyph Lefkowitz > wrote: > >> >> On Jan 28, 2011, at 10:38 AM, Kevin Horn wrote: >> >> >> >> On Fri, Jan 28, 2011 at 7:25 AM, Itamar Turner-Trauring

[Twisted-Python] glossary (was Re: Using SerialPort with t.a.s.Application)

2011-01-28 Thread Glyph Lefkowitz
On Jan 28, 2011, at 5:47 PM, Kevin Horn wrote: > > > On Fri, Jan 28, 2011 at 1:33 PM, Glyph Lefkowitz > wrote: > > On Jan 28, 2011, at 10:38 AM, Kevin Horn wrote: > >> >> >> On Fri, Jan 28, 2011 at 7:25 AM, Itamar Turner-Trauring >> wrote: >> >> A service is supposed >> to be something