improved phpdoc