further improved phpdoc