zendframework/zf2 — pull request #5043 by Danez (2013-08-28 18:10:33+00:00)
Title: DocBlock Reflection not returning correct tags

Currently when using reflection on a phpDoc the tags returned are not as expected. For example for an @return tag i expect Zend\Code\Generator\DocBlock\Tag\ReturnTag to be returned, but instead Zend\Code\Generator\DocBlock\Tag is always returned.

When working on a fix i encountered, that the whole generator tags do not work with reflection at all. e.g. AuthorTag throws an Exception about undefined functions. And the Nameing inside the Zend\Code\Generator\DocBlock\Tag\* is completely of.

I would like to do a little rewrite, without breaking BC:
- [ ] New properties and getter and setters for in Author-, License-, Return-, ParamTag
- [ ] Remove fromReflection() from these tags (in the end one function that decides which Tag to instanciate)
- [ ] Add new classes for Tags similar to the Reflection namespace
- [ ] Move Zend\Code\Generator\DocBlock\Tag to class GenericTag
- [ ] Create a TagManager similar to Reflection namespace (these class decides which class to create)
- [ ] Change DocBlockGenerator to use TagManager

Is there anything planned/done on this?
Is this okay if i do this?
Should I base this on master or development?

Right now I only commited the test for the "bug".