Inherit method documentation through multiple generations

[smaddock]

Fixes #2717

[smaddock]

Just pasting here so it's easy to find.

Error: PHP Fatal error: Uncaught Error: Call to undefined method phpDocumentor\Reflection\Fqsen::getMethods() in /home/runner/work/phpDocumentor/phpDocumentor/src/phpDocumentor/Descriptor/MethodDescriptor.php:265

Code

Check log

[jaapio]

The error you get is because of the design of the descriptors. The workflow is as following.

First we parse all files in a project one by one. If that's done we transform the output of the parsing to descriptors. The links between classes, namepaces ect. are not part of the descriptors at this moment. This allows us to cache the descriptors without to much complexity because the linked objects will have bi-directional relationships.

The next step is to link all objects (replace the FQSEN objects) if this cannot be done (because the actual descriptor doesn't exist) the FQSEN remains part of the list.

So when iterating over the interfaces, you need to check if the returned object is an instance of a InterfaceDescriptorInterface

[smaddock]

Oh, the error is in my unit test. Fixing...

[smaddock]

Okay, I think this will pass all the checks now, but it won't solve issue #2717 until issue #3706 is also fixed.