Dartdoc comments retrieved as metadata through dart2js mirrors.

sdk/lib/_internal/compiler/implementation/mirrors/mirrors.dart

 // Copyright (c) 2012, the Dart project authors.  Please see the AUTHORS file
 // for details. All rights reserved. Use of this source code is governed by a
 // BSD-style license that can be found in the LICENSE file.
 
 library mirrors;
 
 import 'dart:async';
 import 'dart:io';
 import 'dart:uri';
 
@@ skipping 215 matching lines @@
  */
 abstract class TypeInstanceMirror implements InstanceMirror {
   /**
    * Returns the type mirror for the type represented by the reflected type
    * constant.
    */
   TypeMirror get representedType;
 }
 
 /**
+ * Specialized [InstanceMirror] used for reflection on comments as metadata.
+ */
+abstract class CommentInstanceMirror implements InstanceMirror {
+  /**
+   * The comment text as written in the source text.
+   */
+  String get text;
+
+  /**
+   * The comment text without the start, end, and padding text.
+   *
+   * For example, if [text] is [: /** Comment text. */ :] then the [trimmedText]
+   * is [: Comment text. :].
+   */
+  String get trimmedText;
+
+  /**
+   * Is [:true:] if this comment is a documentation comment.
+   *
+   * That is, that the comment is either enclosed in [: /** ... */ :] or starts
+   * with [: /// :].
+   */
+  bool get isDocComment;
+}
+
+/**
  * Common interface for classes and libraries.
  */
 abstract class ContainerMirror implements Mirror {
 
   /**
    * An immutable map from from names to mirrors for all members in this
    * container.
    */
   Map<String, MemberMirror> get members;
 }
@@ skipping 457 matching lines @@
   /**
    * Returns the URI where the source originated.
    */
   Uri get sourceUri;
 
   /**
    * Returns the text of this source.
    */
   String get sourceText;
 }
-
-/**
- * Class used for encoding dartdoc comments as metadata annotations.
- */
-class DartdocComment {
-  final String text;
-
-  const DartdocComment(this.text);
-}