Ongoing attempt to improve documentation.

Following on from my previous pull request #398, I have put some more
effort into improving the documentation across the board.