Extract DocumentationCommentToken with field.

pkg/analyzer/test/generated/parser_test.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.
 
 library engine.parser_test;
 
 import 'package:analyzer/src/generated/ast.dart';
 import 'package:analyzer/src/generated/element.dart';
 import 'package:analyzer/src/generated/error.dart';
 import 'package:analyzer/src/generated/incremental_scanner.dart';
@@ skipping 6724 matching lines @@
         SimpleIdentifier,
         reference.identifier);
     expect(identifier, isNotNull);
     expect(identifier.isSynthetic, isTrue);
     expect(identifier.token, isNotNull);
     expect(identifier.name, "");
     expect(identifier.offset, 5);
   }
 
   void test_parseCommentReferences_multiLine() {
-    CommentToken token = new CommentToken(
+    DocumentationCommentToken token = new DocumentationCommentToken(
         TokenType.MULTI_LINE_COMMENT,
         "/** xxx [a] yyy [bb] zzz */",
         3);
-    List<CommentToken> tokens = <CommentToken>[token];
+    List<DocumentationCommentToken> tokens = <DocumentationCommentToken>[token];
     List<CommentReference> references =
         ParserTestCase.parse("parseCommentReferences", <Object>[tokens], "");
     List<Token> tokenReferences = token.references;
     expect(references, hasLength(2));
     expect(tokenReferences, hasLength(2));
     {
       CommentReference reference = references[0];
       expect(reference, isNotNull);
       expect(reference.identifier, isNotNull);
       expect(reference.offset, 12);
       // the reference is recorded in the comment token
       Token referenceToken = tokenReferences[0];
       expect(referenceToken.offset, 12);
       expect(referenceToken.lexeme, 'a');
     }
     {
       CommentReference reference = references[1];
       expect(reference, isNotNull);
       expect(reference.identifier, isNotNull);
       expect(reference.offset, 20);
       // the reference is recorded in the comment token
       Token referenceToken = tokenReferences[1];
       expect(referenceToken.offset, 20);
       expect(referenceToken.lexeme, 'bb');
     }
   }
 
   void test_parseCommentReferences_notClosed_noIdentifier() {
-    List<CommentToken> tokens = <CommentToken>[
-        new CommentToken(TokenType.MULTI_LINE_COMMENT, "/** [ some text", 5)];
+    List<DocumentationCommentToken> tokens = <DocumentationCommentToken>[
+        new DocumentationCommentToken(
+            TokenType.MULTI_LINE_COMMENT,
+            "/** [ some text",
+            5)];
     List<CommentReference> references =
         ParserTestCase.parse("parseCommentReferences", <Object>[tokens], "");
     expect(references, hasLength(1));
     CommentReference reference = references[0];
     expect(reference, isNotNull);
     expect(reference.identifier, isNotNull);
     expect(reference.identifier.isSynthetic, isTrue);
     expect(reference.identifier.name, "");
   }
 
   void test_parseCommentReferences_notClosed_withIdentifier() {
-    List<CommentToken> tokens = <CommentToken>[
-        new CommentToken(TokenType.MULTI_LINE_COMMENT, "/** [namePrefix some text", 5)];
+    List<DocumentationCommentToken> tokens = <DocumentationCommentToken>[
+        new DocumentationCommentToken(
+            TokenType.MULTI_LINE_COMMENT,
+            "/** [namePrefix some text",
+            5)];
     List<CommentReference> references =
         ParserTestCase.parse("parseCommentReferences", <Object>[tokens], "");
     expect(references, hasLength(1));
     CommentReference reference = references[0];
     expect(reference, isNotNull);
     expect(reference.identifier, isNotNull);
     expect(reference.identifier.isSynthetic, isFalse);
     expect(reference.identifier.name, "namePrefix");
   }
 
   void test_parseCommentReferences_singleLine() {
-    List<CommentToken> tokens = <CommentToken>[
-        new CommentToken(TokenType.SINGLE_LINE_COMMENT, "/// xxx [a] yyy [b] zzz", 3),
-        new CommentToken(TokenType.SINGLE_LINE_COMMENT, "/// x [c]", 28)];
+    List<DocumentationCommentToken> tokens = <DocumentationCommentToken>[
+        new DocumentationCommentToken(
+            TokenType.SINGLE_LINE_COMMENT,
+            "/// xxx [a] yyy [b] zzz",
+            3),
+        new DocumentationCommentToken(TokenType.SINGLE_LINE_COMMENT, "/// x [c]", 28)];
     List<CommentReference> references =
         ParserTestCase.parse("parseCommentReferences", <Object>[tokens], "");
     expect(references, hasLength(3));
     CommentReference reference = references[0];
     expect(reference, isNotNull);
     expect(reference.identifier, isNotNull);
     expect(reference.offset, 12);
     reference = references[1];
     expect(reference, isNotNull);
     expect(reference.identifier, isNotNull);
     expect(reference.offset, 20);
     reference = references[2];
     expect(reference, isNotNull);
     expect(reference.identifier, isNotNull);
     expect(reference.offset, 35);
   }
 
   void test_parseCommentReferences_skipCodeBlock_bracketed() {
-    List<CommentToken> tokens = <CommentToken>[
-        new CommentToken(
+    List<DocumentationCommentToken> tokens = <DocumentationCommentToken>[
+        new DocumentationCommentToken(
             TokenType.MULTI_LINE_COMMENT,
             "/** [:xxx [a] yyy:] [b] zzz */",
             3)];
     List<CommentReference> references =
         ParserTestCase.parse("parseCommentReferences", <Object>[tokens], "");
     expect(references, hasLength(1));
     CommentReference reference = references[0];
     expect(reference, isNotNull);
     expect(reference.identifier, isNotNull);
     expect(reference.offset, 24);
   }
 
   void test_parseCommentReferences_skipCodeBlock_spaces() {
-    List<CommentToken> tokens = <CommentToken>[
-        new CommentToken(
+    List<DocumentationCommentToken> tokens = <DocumentationCommentToken>[
+        new DocumentationCommentToken(
             TokenType.MULTI_LINE_COMMENT,
             "/**\n *     a[i]\n * xxx [i] zzz\n */",
             3)];
     List<CommentReference> references =
         ParserTestCase.parse("parseCommentReferences", <Object>[tokens], "");
     expect(references, hasLength(1));
     CommentReference reference = references[0];
     expect(reference, isNotNull);
     expect(reference.identifier, isNotNull);
     expect(reference.offset, 27);
   }
 
   void test_parseCommentReferences_skipLinkDefinition() {
-    List<CommentToken> tokens = <CommentToken>[
-        new CommentToken(
+    List<DocumentationCommentToken> tokens = <DocumentationCommentToken>[
+        new DocumentationCommentToken(
             TokenType.MULTI_LINE_COMMENT,
             "/** [a]: http://www.google.com (Google) [b] zzz */",
             3)];
     List<CommentReference> references =
         ParserTestCase.parse("parseCommentReferences", <Object>[tokens], "");
     expect(references, hasLength(1));
     CommentReference reference = references[0];
     expect(reference, isNotNull);
     expect(reference.identifier, isNotNull);
     expect(reference.offset, 44);
   }
 
   void test_parseCommentReferences_skipLinked() {
-    List<CommentToken> tokens = <CommentToken>[
-        new CommentToken(
+    List<DocumentationCommentToken> tokens = <DocumentationCommentToken>[
+        new DocumentationCommentToken(
             TokenType.MULTI_LINE_COMMENT,
             "/** [a](http://www.google.com) [b] zzz */",
             3)];
     List<CommentReference> references =
         ParserTestCase.parse("parseCommentReferences", <Object>[tokens], "");
     expect(references, hasLength(1));
     CommentReference reference = references[0];
     expect(reference, isNotNull);
     expect(reference.identifier, isNotNull);
     expect(reference.offset, 35);
   }
 
   void test_parseCommentReferences_skipReferenceLink() {
-    List<CommentToken> tokens = <CommentToken>[
-        new CommentToken(TokenType.MULTI_LINE_COMMENT, "/** [a][c] [b] zzz */", 3)];
+    List<DocumentationCommentToken> tokens = <DocumentationCommentToken>[
+        new DocumentationCommentToken(
+            TokenType.MULTI_LINE_COMMENT,
+            "/** [a][c] [b] zzz */",
+            3)];
     List<CommentReference> references =
         ParserTestCase.parse("parseCommentReferences", <Object>[tokens], "");
     expect(references, hasLength(1));
     CommentReference reference = references[0];
     expect(reference, isNotNull);
     expect(reference.identifier, isNotNull);
     expect(reference.offset, 15);
   }
 
   void test_parseCompilationUnit_abstractAsPrefix_parameterized() {
@@ skipping 4007 matching lines @@
     // Parse the source.
     //
     Parser parser = new Parser(null, listener);
     return invokeParserMethodImpl(
         parser,
         methodName,
         <Object>[tokenStream],
         tokenStream) as Token;
   }
 }