some enhancements/fixes to readme.rst 

Hope it makes sense to you.  Could be updated on pypi via "python setup.py register" without a new release -- as you probably know.