Updated detached tokens of references in documentation comments.

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

 // Copyright (c) 2014, 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.
 
 // This code was auto-generated, is not intended to be edited, and is subject to
 // significant change. Please see the README file for more information.
 
 library engine.parser;
 
 import "dart:math" as math;
@@ skipping 5440 matching lines @@
    * commentReference ::=
    *     '[' 'new'? qualified ']' libraryReference?
    *
    * libraryReference ::=
    *      '(' stringLiteral ')'
    * </pre>
    *
    * @param tokens the comment tokens representing the documentation comments to be parsed
    * @return the comment references that were parsed
    */
-  List<CommentReference> _parseCommentReferences(List<Token> tokens) {
+  List<CommentReference> _parseCommentReferences(List<CommentToken> tokens) {
     List<CommentReference> references = new List<CommentReference>();
-    for (Token token in tokens) {
+    for (CommentToken token in tokens) {
       String comment = token.lexeme;
       int length = comment.length;
       List<List<int>> codeBlockRanges = _getCodeBlockRanges(comment);
       int leftIndex = comment.indexOf('[');
       while (leftIndex >= 0 && leftIndex + 1 < length) {
         List<int> range = _findRange(codeBlockRanges, leftIndex);
         if (range == null) {
           int nameOffset = token.offset + leftIndex + 1;
           int rightIndex = JavaString.indexOf(comment, ']', leftIndex);
           if (rightIndex >= 0) {
             int firstChar = comment.codeUnitAt(leftIndex + 1);
             if (firstChar != 0x27 && firstChar != 0x22) {
               if (_isLinkText(comment, rightIndex)) {
                 // TODO(brianwilkerson) Handle the case where there's a library
                 // URI in the link text.
               } else {
                 CommentReference reference = _parseCommentReference(
                     comment.substring(leftIndex + 1, rightIndex),
                     nameOffset);
                 if (reference != null) {
                   references.add(reference);
+                  token.references.add(reference.beginToken);
                 }
               }
             }
           } else {
             // terminating ']' is not typed yet
             int charAfterLeft = comment.codeUnitAt(leftIndex + 1);
             if (Character.isLetterOrDigit(charAfterLeft)) {
               int nameEnd =
                   StringUtilities.indexOfFirstNotLetterDigit(comment, leftIndex + 1);
               String name = comment.substring(leftIndex + 1, nameEnd);
@@ skipping 514 matching lines @@
    *
    * <pre>
    * documentationComment ::=
    *     multiLineComment?
    *   | singleLineComment*
    * </pre>
    *
    * @return the documentation comment that was parsed, or `null` if there was no comment
    */
   Comment _parseDocumentationComment() {
-    List<Token> commentTokens = new List<Token>();
-    Token commentToken = _currentToken.precedingComments;
+    List<CommentToken> commentTokens = <CommentToken>[];
+    CommentToken commentToken = _currentToken.precedingComments;
     while (commentToken != null) {
       if (commentToken.type == TokenType.SINGLE_LINE_COMMENT) {
         if (StringUtilities.startsWith3(
             commentToken.lexeme,
             0,
             0x2F,
             0x2F,
             0x2F)) {
           if (commentTokens.length == 1 &&
               StringUtilities.startsWith3(commentTokens[0].lexeme, 0, 0x2F, 0x2A, 0x2A)) {
@@ skipping 6012 matching lines @@
    * Copy resolution data from one node to another.
    *
    * @param fromNode the node from which resolution information will be copied
    * @param toNode the node to which resolution information will be copied
    */
   static void copyResolutionData(AstNode fromNode, AstNode toNode) {
     ResolutionCopier copier = new ResolutionCopier();
     copier._isEqualNodes(fromNode, toNode);
   }
 }