Correct some typos and fix some wordings in the documentation

Most importantly, fix the wrong environment variable mentioned in the docs which is used to point at the configuration file, to match what the code actually uses.
Minor clean up of README and setup.py description
Merge pull request #18 from Tenzer/documentation-corrections

Documentation corrections