Fix options.parse_config_file on Python 3.

Add a test for this function.

Closes #702.
Update pypi description field.
Replace the outdated README.md with a lightly-edited version of docs/index.rst
Fix rst markup in readme
Fix another broken link on readme.