Write up a README and improve documentation

This also includes a minor change to the "Reporting Bugs" subheader of
the manpage.

Ref #10