Ensure: link static methods when referenced as default values

[sethladd]

Was https://code.google.com/p/dart/issues/detail?id=18266

For the following method:

min(Iterable iterable, {Comparator comparator = Comparable.compare});

Currently the docs just display the following unstyled text for the default value:

function(Comparable#compare)

It would be useful if it linked to the Comparable.compare docs instead, as references in docs do, with similar styling.

Actually, should have been more general. I would want to link to any public names referenced by the default value expression. Examples:

final Duration ANIM_DURATION_DEFAULT = const Duration(milliseconds: 500);
slideIn(Element el, {Duration duration : ANIM_DURATION_DEFAULT});
fadeIn(Element el, {Duration duration : ANIM_DURATION_DEFAULT});
// ...

addChild(Node child, [Node parent = const Node.root()]) // ...

rotate(num radians, {num min: -PI, max: PI}) // ...

[sethladd]

@seaneagan can you point me to some code in the wild that exhibits this kind of API design?

[sethladd]

We do show and link const values now.

I don't see min(iterable) or addChild(child) in the SDK anymore.

Please re-open if there's a good example for us.