Re: [Twisted-Python] Refactoring Documentation

2011-01-20 Thread Tom Davis
Wow! Okay, so, not being really familiar with the list etiquette combined with the fact that the topic has digressed a bit, I hope you'll forgive the non-inline reply here. I want to hit the main points of what everybody said / asked, but let it be known that I read all of it! How can we combine t

Re: [Twisted-Python] Refactoring Documentation

2011-01-20 Thread Tim Allen
On Thu, Jan 20, 2011 at 06:34:17PM -0600, Kevin Horn wrote: > On Thu, Jan 20, 2011 at 5:57 PM, Tim Allen wrote: > > You mean these DTDs? > > > >twisted/lore/xhtml1-strict.dtd > >twisted/lore/xhtml1-transitional.dtd > > > > They reference the xhtml-*.ent entity definitions which are also in

Re: [Twisted-Python] Refactoring Documentation

2011-01-20 Thread Kevin Horn
On Thu, Jan 20, 2011 at 6:06 PM, wrote: > On 20 Jan, 11:57 pm, screwt...@froup.com wrote: > >On Thu, Jan 20, 2011 at 05:22:55PM -0600, Kevin Horn wrote: > >>Hmmm...yes, I think it does. It looks like the l2s_builder script is > >>choking on fetching the DTD for some reason. lore2sphinx itself i

Re: [Twisted-Python] Refactoring Documentation

2011-01-20 Thread Kevin Horn
On Thu, Jan 20, 2011 at 5:57 PM, Tim Allen wrote: > On Thu, Jan 20, 2011 at 05:22:55PM -0600, Kevin Horn wrote: > > Hmmm...yes, I think it does. It looks like the l2s_builder script is > > choking on fetching the DTD for some reason. lore2sphinx itself is > supposed > > to cache the DTD between

Re: [Twisted-Python] Refactoring Documentation

2011-01-20 Thread exarkun
On 20 Jan, 11:57 pm, screwt...@froup.com wrote: >On Thu, Jan 20, 2011 at 05:22:55PM -0600, Kevin Horn wrote: >>Hmmm...yes, I think it does. It looks like the l2s_builder script is >>choking on fetching the DTD for some reason. lore2sphinx itself is >>supposed >>to cache the DTD between runs, but

Re: [Twisted-Python] Refactoring Documentation

2011-01-20 Thread Tim Allen
On Thu, Jan 20, 2011 at 05:22:55PM -0600, Kevin Horn wrote: > Hmmm...yes, I think it does. It looks like the l2s_builder script is > choking on fetching the DTD for some reason. lore2sphinx itself is supposed > to cache the DTD between runs, but I'm betting it doesn't work in the > buildbot due t

Re: [Twisted-Python] Refactoring Documentation

2011-01-20 Thread Kevin Horn
On Thu, Jan 20, 2011 at 4:45 PM, wrote: > On 10:05 pm, kevin.h...@gmail.com wrote: > >On Thu, Jan 20, 2011 at 1:55 AM, Glyph Lefkowitz > >wrote: > >> > >>(I was going to point you at the output of the buildbot, but it looks > >>like > >>something in trunk has broken the conversion process. Anyon

Re: [Twisted-Python] Flags with MaildirMailbox

2011-01-20 Thread Kevin Horn
On Sun, Jan 16, 2011 at 10:27 AM, goffi wrote: > On 16/01/2011 01:44, exar...@twistedmatrix.com wrote: > > > > Not planned ("planned" in Twisted usually means "there is a ticket for > > it"). You're welcome to contribute that functionality, though! Do you > > have an idea about how it might fit

Re: [Twisted-Python] Refactoring Documentation

2011-01-20 Thread exarkun
On 10:05 pm, kevin.h...@gmail.com wrote: >On Thu, Jan 20, 2011 at 1:55 AM, Glyph Lefkowitz >wrote: >> >>(I was going to point you at the output of the buildbot, but it looks >>like >>something in trunk has broken the conversion process. Anyone know >>what this >>is about? < >>http://buildbot.tw

Re: [Twisted-Python] Refactoring Documentation

2011-01-20 Thread Kevin Horn
On Thu, Jan 20, 2011 at 1:55 AM, Glyph Lefkowitz wrote: > > (I was going to point you at the output of the buildbot, but it looks like > something in trunk has broken the conversion process. Anyone know what this > is about? < > http://buildbot.twistedmatrix.com/builds/sphinx-html-15724/contents.

Re: [Twisted-Python] Refactoring Documentation

2011-01-20 Thread Kevin Horn
I alluded in my earlier mail to some of the improvement ideas I have had regarding Twisted's docs (other than the conversion to Sphinx), and I though I'd elaborate Here's some things I had "planned" (yes, I'm using the term loosely) to try and add/improve/fix in the Twisted docs after the Sphinx c

Re: [Twisted-Python] Refactoring Documentation

2011-01-20 Thread Kevin Horn
On Thu, Jan 20, 2011 at 1:55 AM, Glyph Lefkowitz wrote: > Let me begin by saying that I'm _very_ excited about this prospect and I'm > looking forward to the output of this project. So, some of what I'm about > to say may sound like harsh criticism but *please do not let it discourage > you*. I

Re: [Twisted-Python] Question about SerialPort

2011-01-20 Thread Jason Valenzuela
On 1/20/2011 9:42 PM, James Y Knight wrote: > On Jan 20, 2011, at 6:32 AM, Albert Brandl wrote: >> The main problem seems to be the specification of Modbus RTU. RTU >> messages are separated by time gaps that are at least 3.5 characters >> long. Unfortunately, this is the only reliable way for sepa

Re: [Twisted-Python] Question about SerialPort

2011-01-20 Thread Albert Brandl
On Thu, Jan 20, 2011 at 08:42:58AM -0500, James Y Knight wrote: > I don't think you'll ever be able to do this reliably in Python. At > 9600 baud, 3.5 characters is just about 275hz (9600/10/3.5). Linux > schedules process at around 500hz. Well, that's bad news - I'll have to communicate with t

Re: [Twisted-Python] Refactoring Documentation

2011-01-20 Thread Victor Norman
Hear! Hear! My major disappointment with Twisted is its documentation. I've used many many packages over the years, some with books and books of documentation (HP OpenView, e.g.), but I've never encountered a package with poorer help for a newbie. I finally started to get it when I stumbled upon

Re: [Twisted-Python] Refactoring Documentation

2011-01-20 Thread Jason Rennie
On Thu, Jan 20, 2011 at 2:55 AM, Glyph Lefkowitz wrote: > (minor nitpick: I really like "event-based" or "event-driven", as you've > said here: why does say > "asynchronous"? I find that especially in documentation it's a lot easier to > explain "event-dri

Re: [Twisted-Python] Question about SerialPort

2011-01-20 Thread James Y Knight
On Jan 20, 2011, at 6:32 AM, Albert Brandl wrote: > The main problem seems to be the specification of Modbus RTU. RTU > messages are separated by time gaps that are at least 3.5 characters > long. Unfortunately, this is the only reliable way for separating > messages - there is no length header or

[Twisted-Python] Question about SerialPort

2011-01-20 Thread Albert Brandl
Hi! I am trying to read Modbus RTU messages over the serial line. There is a library called pyModbus which is very usable for Modbus TCP/IP, but the support for RTU is a bit lacking. The main problem seems to be the specification of Modbus RTU. RTU messages are separated by time gaps that are at