updated README.md to make it somewhat closer to what the repo really is nowadays
integrating fixes from review
a couple more fixes
Merge pull request #137 from dontcallmedom/master

Updated README to match more closely reality