Clarify docblocks, fixes #142