Miscelaneous spell fixes and rst formattings

As requested, this patch is made on top of Kees patch to fix spelling mistakes on README.rst.

It also makes some rst fixes too.