stylistic fixups to README
a few more formatting fixes
Merge pull request #1 from tgerla/master

Fix up formatting in README and add a few warnings