Description: ------------ it would be helpful if @return would allow specifying the type of array values, e.g. @return array(MyClass) Array of MyClass objects

An option mentioned on the Sourceforge forums [1] is to use the "generics" syntax: @return array<MyClass> array of MyClass objects [1] - https://sourceforge.net/forum/message.php?msg_id=4889244

I think it would be very helpfull to specify several ways to specify return value. I really need, for example, this ways: * Array(MyClass) * Array( SOME_CONSTANT => MyClass ) * Array( SOME_CONSTANT => Array(SOME_CONST1 => MyClass1 , SOME_CONSTANT2 => MyClass2 ) ) The last 2 ways are very usefull if you use assotiative arrays as a return values. If it's possible i could do this features by myself, but i don't really know how and where change source code. Please contact me (StepLg [@] GMail.com without []) about this question.

There are a few different patterns in use in the wild. The PHPStorm IDE uses Foo[] where Foo is the type. PHPLint uses array[Bar]Foo where Bar is the array key type and Foo is the array value type.

No more feature work on phpDocumentor 1.x. Check out the new phpDocumentor 2.x (http://www.phpdoc.org/).