second pass PHPdoc, basics are done