Various fixes to markup and documentation

* Small markup fixes to CHANGES.txt and README.rst files
  [alecghica]
* Fixed long_description under setup.py to make changelog appear under PyPi
  package description page
  [alecghica]