Updated detached tokens of references in documentation comments.

pkg/analyzer/lib/src/generated/scanner.dart

Index: pkg/analyzer/lib/src/generated/scanner.dart
diff --git a/pkg/analyzer/lib/src/generated/scanner.dart b/pkg/analyzer/lib/src/generated/scanner.dart
index af06edfc94ec8ab6a79436590c47fbfde98e372d..2efcb808bf81b177b311e5b4b45c7968702d43aa 100644
--- a/pkg/analyzer/lib/src/generated/scanner.dart
+++ b/pkg/analyzer/lib/src/generated/scanner.dart
@@ -239,6 +239,13 @@ class CommentToken extends StringToken {
   Token parent;
 
   /**
+   * The references embedded within the documentation comment.
+   * This list will be empty unless this is a documentation comment that has
+   * references embedded within it.
+   */
+  final List<Token> references = <Token>[];

[Brian Wilkerson, 2014/12/01 19:41:19]

How hard would it be to have a subclass of CommentToken named something like
DocumentationCommentToken that had a actual field for 'references' and a getter
in CommentToken that returned an unmodifiable empty list of tokens? It would be
nice to not have the extra objects taking up space when we don't need them.

[scheglov, 2014/12/01 22:49:22]

https://codereview.chromium.org/768233002

+
+  /**
    * Initialize a newly created token to represent a token of the given [type]
    * with the given [value] at the given [offset].
    */
@@ -2022,7 +2029,7 @@ class Token {
    * the first preceding comment token will have a lexeme of "/* one */" and
    * the next comment token will have a lexeme of "/* two */".
    */
-  Token get precedingComments => null;
+  CommentToken get precedingComments => null;
 
   /**
    * Apply (add) the given [delta] to this token's offset.