fixed decoration to maintain the function signature for decorated things
minor notes and doc changes
actually fixed decoration, added metaclass for handling of _live objects