Added Area-Pkg, Triaged labels.

This comment was originally written by @seaneagan

This is for dart:mirrors, so Area-Library ?

This comment was originally written by @seaneagan

Apparently including Comments in DeclarationMirror.metadata is already implemented by dart2js mirrors:

https://code.google.com/p/dart/source/browse/branches/bleeding_edge/dart/sdk/lib/_internal/compiler/implementation/mirrors/dart2js_mirror.dart#­364

Removed Type-Defect, Area-Pkg labels.
Added Type-Enhancement, Area-Library, Library-Mirrors labels.

This comment was originally written by @seaneagan

Another use case for this:

google/grinder.dart#103

I think the reflectable package should be able to solve this nicely, so filed an issue there:

google/reflectable.dart#3

The dart2js_mirrors.dart link in #­3 does not work from here (possibly not at all) any more, and the version of that file that I can find may differ from what you have seen. However, I tried out this:

import 'dart:mirrors';

/// DartDoc comment
class A {}

main() {
  DeclarationMirror declarationMirror = reflectType(A);
  List metadata = declarationMirror.metadata;
  print(metadata);
}

which prints the empty list (so the doc comment is not included). I guess this is because mirrors.compiler.commentMap[getBeginToken()] is empty, but in any case it looks like a bug. So I'll assume that it will be supported. Based on that, it makes sense to make Reflectable behave in the same way (such that doc comments are included in the result returned by metadata on a DeclarationMirror). See google/reflectable.dart#3 for a slightly more detailed explanation.