fix various documentation xrefs

While reading the documentation, I encountered quite a few places where cross-references did not work.

This pull request is to fix some of them (I'm not sure if I fixed all of them :)).