On Thu, 29 May 2003, david mertz <ibook@gnosis.cx> wrote:
To Andrew, and generally: I have installed a local copy of 1.0.5, and that at least makes the PicturePile example work (there are a few minor errors in the samples, but straightforward to fix)
Moshe Zadka wrote: |There is a reason the documentation comes with the package: |it is relevant to the version it comes with. In particular, the |documentation on tm.com is only relevant to "latest stable". This is |just like Python: if you read documentation from |http://www.python.org/doc/current/, don't count on it working with |Python 2.1. This is very unhelpful, Moshe. The documentation on the Twisted website (as mentioned in my earlier note), unlike most Python standard documentation, does not indicate in which versions the examples work (PicturePile, specifically). Nothing like "new in 1.0.4". Moreover, the errors did not make it obvious there was a version issue (and in any case, the example still needed some minor corrections to work with 1.0.5). Andrew's advice (and some by email) was helpful, but it was hardly obvious a priori what the issue was. Moreover, I have not encountered any change log that addresses woven version differences in any detail. Quite possibly there is such a document, but I do not now know where it is. None of this, btw., means to demean Twisted itself. I do think it could use a bit more directed documentation, but the concept and subpackages themselves seem very useful and well conceived. Yours, David...