minor fixes, added comments, improved readme
extended readme
Merge pull request #212 from voisardf/minorupdates

Minorupdates