Documentation fixes

Hi folks,

Sorry, this is not an exciting code contribution... but since I had to read the documentation anyways, I decided to fix whatever problems caught my attention in the process.

I tried to make my changes modular, so if you don't like something, just drop the corresponding patch.

HTH and thanks for working on Cython,

--Yury.