Docs of parent class are not overridden

[sebamarynissen]

I posted a question on Stackoverflow, and they suggested that I'd report it here as a bug.
Link: http://stackoverflow.com/questions/18411454/phpdocumentor-does-not-override-docs-of-parent-class

[mvriel]

Thanks, I am going to look into this

[cweiske]

an IRC user reported this, too.

[akeiper]

I ran into the same issue today.

[alfaproject]

I just ran in this issue today as well.

[dial033]

Same problem here, version 2.0.1. But this is just a minor bug, since inheritance is a very uncommon thing in OO code ;o)
For completeness sake: You cannot work around this by not putting a comment on the parent method, you will have no documentation at all in this case.

[mnoebel]

I have the same issue with version 2.2.0.
Any workarround known?

[blackdrago]

I have this same issue with version 2.2.0. It's particularly problematic for my project because almost all my classes inherit from one super-parent class.

Another issue comes from abstract methods in abstract parent classes -- when a subclass implements a non-abstract version of the method, the documentation retains the 'abstract' label for the subclass.

I've tried removing all @inheritdoc tags from the subclass descriptions, but the parent documentation persists.

If it's helpful, I could upload the API documentation as it generates now with some of my code to show how I'm formatting.

UPDATE: This seems to be a template-specific (or template-related) issue:
-- responsive-twig -- this happens every time
-- old-ocean -- this happens rarely (haven't figured out a pattern)
-- responsive -- this never happens
-- abstract -- this never happens
-- zend -- this never happens

Switching from the repsonsive-twig template to the responsive template has fixed this issue for me.

I think the issue might be with how the responsive-twig handles the commenting code. It's the only template that consistently gives me this issue.

Alternatively, a similar problem will sometimes occur with all templates (except responsive-twig) where {@inheritdoc} is displayed instead of the inherited documentation.

[kenxle]

Bump. This is a major issue. Can't get child class documentation, which is far more relevant than docs they inherit.

Will check out the solution from @blackdrago

UPDATE:
After a brief check, I can confirm that child classes are showing proper documentation with the following templates:
-- abstract
-- responsive

[mvriel]

I am working on this item but due to some design restrictions it takes some time to fix this in a performant manner