I just committed htdocs/manual/misc/descriptors.html which tries to document the descriptors problem and workarounds. It's incomplete, and I only spent about 20 minute writing it. It's only in HEAD right now ... feel free to add to it before I merge it in with 1.2.1. Dean