Since the prechecker results for plugins are now public, and they show hundreds of errors for one of my plugins, I thought I'd look into these for the next release. (Hardly any of these errors would ever affect the user, so you might say the whole point is rather moot, but I thought I might want to do some cleanup nevertheless.)
About 70% of these errors relate to PHPDoc. Some of them are legitimate, but one main point seems to be that the checker complains about absent PHPDoc comments for overridden methods (when the intention is to retain the comment from the parent method).
Now I'm certainly not going to copy the PHPDoc from the superclass down to a dozen of subclasses just to please the automated checker - that would be possible but outright stupid.
The developer docs say on this issue:
An exception is made for overridden methods which make no change to the meaning of the parent method and maintain the same arguments/return values. In this case you should omit the comment completely. Use of the @inheritdoc or @see tags is explicitly forbidden as a replacement for any complete docblock.
How do I make the the prechecker recognize this?