phpdoc fixes for public api