some phpdoc improvements