3.0 api docs

Update the API docs for a bunch of directories. I'll do some more once this has been merged. My goal is to get the PHPCS build back running again.
Above it's `@param \PHPUnit_Framework_TestSuite` - so must this be then `@param \PHPUnit_Framework_Test` (slash prepended)?