Finish README

Well that was a lot of work
Merge pull request #2 from bar9/readme-edits

Readme edits, fixes #1