restructured text fixes based on your fork

Hi Wichert,

Ok, I've managed to get git to merge/rebase/whatever the changes I made on top of your fork. I probably committed some git offenses in the process, but in the end only a couple of changes to README.rst are in the actual set of changes. (You did all other changes I had on your fork already :-) )

Perhaps you ought to just apply a plain patch to your fork, however, as I'm still learning git.