Some classes don't list their subclasses

[Hixie]

Seen on the Flutter documentation. It used to be that the widgets library version of RenderObjectWidget didn't have subclasses listed, but the material version did. Now, however, it's even worse, because since we (correctly) don't include the material version, the list is entirely unavailable.

e.g.: http://docs.flutter.io/flutter/widgets/RenderObjectWidget-class.html

[sethladd]

For completeness, what would you expect to see?

[Hixie]

Well for example InkResponse has a line that says "Implemented by InkWell TableRowInkWell":
https://docs.flutter.io/flutter/material/InkResponse-class.html

I would expect that on the page of any class with subclasses.

[Hixie]

Related bugs that might be easy to fix at the same time: #1069, #901

This actually might be a dupe of 1069, I'm not quite sure.

[sethladd]

Yeah, this is an important one to fix.

[jcollins-g]

If I understand correctly, any class that extends/implements another class in the same library should be mentioned in the parent class doc under "Implemented by:". A specific example for RenderObjectWidget would be the subclasses MultiRenderObjectWidget and LayoutBuilder. It looks like the code tries to do this already; I'll investigate why these cases get dropped.

[sethladd]

I'll investigate why these cases get dropped.

Thanks for taking a look!

[jcollins-g]

Swung back around to this and I think I've found the root of the problem. The _implementors map is sometimes accessed with Class objects that are different than the ones used to build the map. This should be fairly straightforward to correct.

[jcollins-g]

Actually, it's weirder than that. While processing the material library, the class html file for RenderObjectWidget in *widgets* gets written, with the correct "Implemented by" section. But then as the code continues to process the widgets library, the html file is overwritten with the wrong Implemented by section. Not clear yet to me what causes this.