improved phpdoc documentation