Various fixes

* 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]
* Cleanup empty spaces.
  [alecghica]
* Updated documentation.
  [alecghica]