Fixes #75, documented failure return type
Merge pull request #90 from sambohler/master

Fixes #75, documented failure return type