Include subtype information in generated docs.

Include subtype information in generated docs.

With this change, dartdoc does a more comprehensive job of letting users
navigate the web of types. For each class, this will show its chain of
superclasses, interfaces it implements, and its immediate subclasses.

For interfaces, it shows superinterfaces, subinterfaces, implementing classes,
and a default class if it has one.

Committed: https://code.google.com/p/dart/source/detail?r=3515

[Bob Nystrom, 2012-01-20 22:46:49]

To see it in action, I put some generated docs up at:
http://stuffwithstuff.com/temp/docs

A few interesting examples:
http://stuffwithstuff.com/temp/docs/dart_core/List.html
http://stuffwithstuff.com/temp/docs/lang/DotExpression.html
http://stuffwithstuff.com/temp/docs/lang/Expression.html

[nweiz, 2012-01-21 01:11:15]

lgtm

https://chromiumcodereview.appspot.com/9271020/diff/1/utils/dartdoc/dartdoc.dart
File utils/dartdoc/dartdoc.dart (right):

https://chromiumcodereview.appspot.com/9271020/diff/1/utils/dartdoc/dartdoc.d...
utils/dartdoc/dartdoc.dart:541: if (type.name.startsWith('_')) continue;
You already filtered for this.

[Siggi Cherem (dart-lang), 2012-01-21 01:57:25]

lgtm

I especially like how the superclasses chain looks.

https://chromiumcodereview.appspot.com/9271020/diff/1/utils/dartdoc/dartdoc.dart
File utils/dartdoc/dartdoc.dart (right):

https://chromiumcodereview.appspot.com/9271020/diff/1/utils/dartdoc/dartdoc.d...
utils/dartdoc/dartdoc.dart:574: listTypes(type.subtypes, 'Subclasses');
it would be nice to sort these by name

[Bob Nystrom, 2012-02-01 21:41:56]

Heh, never sent these...

https://chromiumcodereview.appspot.com/9271020/diff/1/utils/dartdoc/dartdoc.dart
File utils/dartdoc/dartdoc.dart (right):

https://chromiumcodereview.appspot.com/9271020/diff/1/utils/dartdoc/dartdoc.d...
utils/dartdoc/dartdoc.dart:541: if (type.name.startsWith('_')) continue;
On 2012/01/21 01:11:15, nweiz wrote:
> You already filtered for this.

Done.

https://chromiumcodereview.appspot.com/9271020/diff/1/utils/dartdoc/dartdoc.d...
utils/dartdoc/dartdoc.dart:574: listTypes(type.subtypes, 'Subclasses');
On 2012/01/21 01:57:25, sigmund wrote:
> it would be nice to sort these by name

Done.