Clean up some formatting.

Our docstrings should now be PEP257 compliant. We added and clarified a few
comments and docstrings. We broke up a long line that was making pylint
unhappy.