Improve doc for ClosureMirror.function.

Improve doc for ClosureMirror.function.

R=gbracha@google.com

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

[rmacnak, 2014-05-06 20:12:21]

https://codereview.chromium.org/266923009/diff/20001/sdk/lib/mirrors/mirrors....
File sdk/lib/mirrors/mirrors.dart (right):

https://codereview.chromium.org/266923009/diff/20001/sdk/lib/mirrors/mirrors....
sdk/lib/mirrors/mirrors.dart:510: MethodMirror get function;
Actually, the accessors on FunctionTypeMirror would seem to imply there must be
a distinct closure class for each signature.

https://codereview.chromium.org/266923009/diff/20001/sdk/lib/mirrors/mirrors....
sdk/lib/mirrors/mirrors.dart:847: MethodMirror get callMethod;
When might this be different than declarations[#call] ?

[gbracha, 2014-09-11 00:49:33]

https://chromiumcodereview.appspot.com/266923009/diff/20001/sdk/lib/mirrors/m...
File sdk/lib/mirrors/mirrors.dart (right):

https://chromiumcodereview.appspot.com/266923009/diff/20001/sdk/lib/mirrors/m...
sdk/lib/mirrors/mirrors.dart:510: MethodMirror get function;
On 2014/05/06 20:12:21, rmacnak wrote:
> Actually, the accessors on FunctionTypeMirror would seem to imply there must
be
> a distinct closure class for each signature.

I don't think so today. Just as function could return a different value from a
common class (by storing it in a field), the same would be true of the type
accessors.

I think it might be nice to explain this subtlety in the comment as well.

https://chromiumcodereview.appspot.com/266923009/diff/20001/sdk/lib/mirrors/m...
sdk/lib/mirrors/mirrors.dart:847: MethodMirror get callMethod;
On 2014/05/06 20:12:21, rmacnak wrote:
> When might this be different than declarations[#call] ?

It wouldn't be but it's here.

[gbracha, 2014-09-11 15:07:27]

lgtm

[rmacnak, 2014-09-11 16:48:49]

Committed patchset #3 (id:40001) manually as 40160 (presubmit successful).