Readme updated to be pypi/rst compilant (project description)

Must run python setup.py sdist register upload
to overwrite project description
Merge branch 'fix-readme'