Update docstrings to reflect reality
Merge pull request #97 from jonboulle/master

Update docstrings to reflect current state of handlers