Switch README to restructured text.

For compatibility with PyPI.
Couple more edits for PyPI compatibility.
Add README.rst to MANIFEST.in for source distribution.
Merge pull request #109 from synthicity/readme-rst

Convert README to restructured text