I have tried that before and it works fine, but I suppose I was just hoping for something a bit more semantic.
For example, if I put this into my class phpdoc:
@method array compare
I have to back it up with a comment to explain what it is.
I also have to put a comment over the call to provide further info. Otherwise a newbie will go searching through the controller for a method that doesn’t exist. Also if you use PhpStorm’s “Go To Declaration or Implementation” tools, they’ll just take you to the @method declaration rather than the behaviour itself.
It’s no big deal anyway and it’s more a limitation of PhpStorm than Yii. Just one of those little annoyances.
Thanks again for your input. It’s greatly appreciated!