Some phpdoc improvments

Improved return / throws / param phpdoc descriptions.