More changes to comments

Improvements to #10, as mentioned in #12.