Comment clarifications.
Merge pull request #1937 from jimis/master

Comment clarifications.