fixed typo in code comment.
fixed typos in code comments.
fixed erroneous/incomplete method docblocks. punctuation changes.
Merge pull request #271 from stopfstedt/master

comments cleanup.