some phpdoc updates