Update documentation to reflect reality

Minor typos and corrections to bring the readme more inline with the source
Merge pull request #12 from karlp/docupdates

Update documentation to reflect reality