A couple of improvements to the documentation.

Fixes #5 and reflects my error handling changes earlier.