Update code docs to be more PEP257-compliant

Turns out, since I wrote this package before I started caring about PEP257
compliance, it's going to be non-trivial to convert everything to be strictly
compliant plus have the Sphinx-generated documentation look sane. So I'm not
ready to add the pep257 checker to the test runner.