README.rst tweaks

Tiny corrections + add code-blocks for syntax highlighting
README.rst: Fix a couple of things
Merge pull request #4 from msabramo/patch-1

README.rst tweaks