woocommerce.php PHPDoc cleanup: correct @returns and @deprecated markup
Merge pull request #3830 from tivnet/master

woocommerce.php PHPDoc cleanup: correct @returns and @deprecated markup