Hi out there<br><br>Let me tell you about my experience with TM so far ...<br><br>Seeing there is doc. available, I digged through it. After all TM seems worth the effort. From what I see, I love TM.<br><br>Links are&nbsp;often broken, though. Often seemingly useful doc. is old, very old. Even current doc. isn&#39;t up to date.<br>
<br>Anyway, I try and I mean I try hard to get on my feet following some examples and snippets. The problem isn&#39;t the deferreds.&nbsp;I&nbsp;understand&nbsp;them&nbsp;pretty&nbsp;quickly&nbsp;and&nbsp;like&nbsp;them. The problem is that the docs are like a maze, irritating, frustrating and misleading rather than helping.<br>
<br>Trying to write a rpy. Of course, it doesn&#39;t work.&nbsp;Looking&nbsp;at&nbsp;all&nbsp;those&nbsp;different&nbsp;docs,&nbsp;I&#39;m&nbsp;bewildered.&nbsp;Somehow&nbsp;hacking&nbsp;my&nbsp;way&nbsp;through&nbsp;it.<br> They talk about &quot;resource trees&quot;, yet I don&#39;t find them in the doc. I find putchild() but all examples and docs indicate, that you can do it only within the root resource.<br>
Again browsing, again looking desperately for some docs, that don&#39;t mislead and make things even more fuzzy. Falling over an article with some halfway useful tap doc.<br> OK, a little later, I have&nbsp;my&nbsp;first&nbsp;web&nbsp;server&nbsp;running&nbsp;an&nbsp;my&nbsp;first&nbsp;rpy&nbsp;works,&nbsp;spitting&nbsp;out&nbsp;&quot;test&quot;.&nbsp;Wow.<br>
 <br>I&#39;m wondering, why of all things &quot;rpy&quot; ? python won&#39;t generate sth. like &quot;rpyc&quot; for that, which translates in lost speed, I assume. No explanation. <br><br>I&#39;m on FreeBSD. Of course, I want to use kqueue. Now, another &quot;funny&quot; journey begins ...<br>
the py-kqueue in FreeBSD 6.3 and 7.0 is version 1.4. I remember, however, having read something by Isthmar Trauring Shtull (forgive me, if I didn&#39;t spell that correctly) that I need version 1.3 in order to apply his patch, which, of course (sorry, that&#39;s my disappointment carrying me away ...), doesn&#39;t work. No prob, I do it by hand.&nbsp;To&nbsp;no&nbsp;avail.&nbsp;That&nbsp;code&nbsp;is&nbsp;old,&nbsp;very&nbsp;old&nbsp;and&nbsp;it&nbsp;doesn&#39;t&nbsp;work.<br>
 I remember havin seen some version 2 of pykqueue. Setup works nicely but Python/twisted coughs. The module has another name now. &quot;(%&quot;%§$( !!!<br>So I fall back to the version 1.4 that comes with FreeBSD ports. It works. But in no-deamon mode only. As soon as I tell twistd to run web.tap  deamonized it vomitts and breaks.<br>
<br>Intense googleing, and I mean &quot;intense&quot;. Reading through years of this mailing list. No positive result.<br><br>What I say is said, because I love python an I consider twisted brilliant and immensely useful - theoretically. So, don&#39;t get me wrong and accept it as constructive, albeit somewhat pissed off remarks, OK :)<br>
<br>I have the clear impression that twisted is something in between a toy and a brilliant product. It&#39;s hackers, however, leave much to be desired in terms of usefulness. As it is, it&#39;s a great&nbsp;and&nbsp;promising hobby but not a useful product.<br>
<br>Sorry, but doc strings don&#39;t replcae a halfway decent documentation and a reasonable tutorial, considering the highly complex matter.<br>Sorry, but documentation that is often enough outdated and sometimes offers broken links is next to useless.<br>
Sorry, but the most brilliant code is a lot less attractive and useful, if even &quot;stable versions&quot; are broken, in flux, etc ...<br><br>Kqueue seems to be vital to an event driven approach like TM, yet there are multiple versions of&nbsp;pykqueue&nbsp;floating around,&nbsp;none&nbsp;of&nbsp;them&nbsp;properly&nbsp;working&nbsp;(and&nbsp;I&nbsp;didn&#39;t&nbsp;fumble&nbsp;around.&nbsp;I&nbsp;plain&nbsp;simply&nbsp;used&nbsp;the&nbsp;FreeBSD&nbsp;port),&nbsp;some&nbsp;of&nbsp;<br>
them&nbsp;with&nbsp;some&nbsp;mor&nbsp;and&nbsp;some&nbsp;with&nbsp;some&nbsp;less&nbsp;&quot;annotations&quot;&nbsp;(I&nbsp;refuse&nbsp;to&nbsp;call&nbsp;that&nbsp;doc.)<br> <br>- How about getting 1 version of pykqueue properly running and into TM ?<br>- How about freezing some TM version (like 8.0) and updating/matching docs? (Of course, experiments are funny and intriguing, but quite some of us out here need sth. stable for everydays work)<br>
- How about writing some complete docs and tutorials? Sth. along the lines of &quot;My first web server wit TM&quot; (instead all those - sometimes seeming to contradict each other - snippets)<br><br>I&#39;m still fascinated by TM and still willingto invest time,&nbsp;efforts and brains.&nbsp;But&nbsp;I&#39;d&nbsp;love&nbsp;to&nbsp;have&nbsp;some&nbsp;properly&nbsp;working&nbsp;base&nbsp;and&nbsp;docs&nbsp;that&nbsp;expßlain&nbsp;rather&nbsp;than&nbsp;confuse.<br>
  <br>Looking forward to learn and enjoy.<br><br>(Yes, Should someone need sth. tested on FreeBSD, I&#39;ll gladly be of service)<br><br>