decorated functions do not have sensible signatures/docstrings

https://micheles.googlecode.com/hg/decorator/documentation3.html#definitions goes a bit into the problems it causes, same for the functools library

more practically: http://i.imgur.com/2vt7Awi.png (IPython) | http://i.imgur.com/kWO7AOK.png (dreampie

neither responses explain the interface of the actual function/class

this is probably fairly low priority, but it can be useful for IDEs / custom interpreters

might not be practical/useful once auto-populated interfaces become used more (unless the interfaces provide documentation)

[smiley]

Oh, forgot about this decorator issue. Does this screw up any other functions/classes? I'll fix this, but APIConnection will soon be retired for an instance-based solution (like APIInterface in the "autopopulated-interfaces" branch) rather than a singleton-based solution.

It only affects the APIConnection from the looks of things.

Considering that is only just the 1 object, and it is documented in the examples, (and the impending retirement),definitely a low priority