I'm working with the PHPDoc documentation on method signatures, classes, etc.
In the official PHPDoc Tag list (find it here: http://manual.phpdoc.org/HTMLSmartyConverter/HandS/phpDocumentor/tutorial_tags.pkg.html), there is a @deprecated tag, which is quite useful, if you are working with some legacy code and refactor it.
I would love to see a feature, where the usage of an as @deprecated marked method/function/... is highlighted somehow (underline it or sth).
And the last one:
Is it possible to disable the automatical addition of "@return void"?
According to Wikipedia, it is not recommended: http://en.wikipedia.org/wiki/PHPDoc#Tags