Недавно узнал от товарища одну особенность у IDE Eclipse и проверил ее в NetBeans. При написании коментария к функциям синтаксисом PHPDocumentor(etc...), примерно так:

/**
* @return CommonObject
*/

Если функция неявно возвращает объект, то IDE увидя такой тег, будет считать, что функция возвращает объект класса CommonObject и соответственно сделает правильное подсвечивание кода.