improved PHPDoc