Updating comments to be more accurate and fix typos
Merge pull request #344 from Kapin/master

Fixing comments to better reflect how methods work and some typo fixes