Another almost pointless documentation commit.

Maybe time to start putting this stuff on a separate branch, and pull it
into master when it's substantially complete?