That's just lazy javadoc style. The worst kind of documentation, since it adds nothing over looking at code itself.

At the very least, there should be examples of usage.

I never did PHP, but they have one of the best documentation features: comments. It allows you to recognize if a function is a footgun: https://www.php.net/manual/en/function.utf8-decode.php