dartdoc: documentation for public class extending private class

[kevmoo]

What steps will reproduce the problem?

1. create a public class that extends a private class. See diff:
   kevmoo/bot.dart@3de76d8
2. Generate docs. See diff:
   kevmoo/bot.dart@248d564

What is the expected output? What do you see instead?

Ideally: the private class would be invisible. Members inherited from the private class would appear as defined locally.

Instead I see a link to a documentation file that doesn't exist for the class.

What version of the product are you using? On what operating system?

r15355, Mac

[anders-sandholm]

Added Area-DartDoc, Triaged labels.

[DartBot]

This comment was originally written by amouravski@google.com

---

Set owner to amouravski@google.com.
Added Accepted label.

[DartBot]

This comment was originally written by amouravski@google.com

---

Added Triaged label.

[DartBot]

This comment was originally written by amouravski@google.com

---

Removed the owner.

[alan-knight]

I believe this works in the new Dartdoc, but we should verify before closing.

---

Added this to the M8 milestone.
Removed Area-DartDoc label.
Added Area-DartDocNext, Accepted labels.

[alan-knight]

This is partially working. e.g. KeyEvent shows as inheriting from Object, but it shows inherited methods from _WrappedEvent, e.g. bubbles. It's showing from the dart2js implementation, there's a different bug to switch it.

---

Removed this from the M8 milestone.
Added this to the M9 milestone.

[alan-knight]

Added Library-Docgen label.

[clayberg]

Removed this from the M9 milestone.
Added this to the 1.1 milestone.

[alan-knight]

Show methods inherited from _WrappedEvent is as designed in this case. If the method can be shown as inherited from a public class we show it, but if something is inherited from a private class and there's no other source we can show it from (e.g. we can't claim it's inherited from Object) then we show the name, but not as a link. So calling this closed.

---

Added Fixed label.

[kevmoo]

Re-opening per conversation at lunch.

If X inherits from private class _Y, the fact that its members come from _Y is an implementation detail.

I'd argue we should not show any inheritance info for these members -- make them appear as if they were defined in X.

---

cc @efortuna.
Added Triaged label.

[anders-sandholm]

Removed Area-DartDocNext label.
Added Area-DartDoc label.

[anders-sandholm]

Removed Library-Docgen label.

[alan-knight]

Removed this from the 1.1 milestone.

[kevmoo]

Added Pkg-DartDoc label.

[kevmoo]

Removed Area-DartDoc label.
Added Area-Pkg label.