Hmm - I've just spotted [@method](http://manual.phpdoc.org/HTMLSmartyConverter/PHP/phpDocumentor/tutorial_tags.method.pkg.html) in phpdoc, which is a much better way of doing this, I suspect.