Documentation scrub

Major cleanup to the class docs to make phpdoc work more reliably.