improve some phpdoc