Improved comments.
Merge pull request #1 from cogspace/master

Thanks very much!