Add subscribe decorator for use with event handlers.  Revise events documentation.
Add tests for subscribe decorator.
Fix wrong and add missing API docs.
Merge pull request #217 from disko/feature/event_subscription

Feature/event subscription