Some tweaks for the sphinx docs

Also: there is alot of copied information now between the sphinx docs and the
README.rst. I don't favour duplication of information. Perhaps we could slim
down the README.rst to contain only the necessary info. Alternatively, one
could symlink the README.rst into the docs directory. Since it is RST, it can serve
as input to sphinx.

What do you think?