fasta.Token implement analyzer.Token

pkg/front_end/lib/src/scanner/token.dart

 // Copyright (c) 2016, 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.
 
 /**
  * Defines the tokens that are produced by the scanner, used by the parser, and
  * referenced from the [AST structure](ast.dart).
  */
 import 'dart:collection';
 
@@ skipping 674 matching lines @@
    * Return the type of the token.
    */
   TokenType get type;
 
   /**
    * Apply (add) the given [delta] to this token's offset.
    */
   void applyDelta(int delta);
 
   /**
-   * Return a newly created token that is a copy of this token but that is not a
-   * part of any token stream.
+   * Return a newly created token that is a copy of this tokens
+   * including any [preceedingComment] tokens,
+   * but that is not a part of any token stream.
    */
   Token copy();
 
   /**
    * Copy a linked list of comment tokens identical to the given comment tokens.
    */
   Token copyComments(Token token);
 
   /**
    * Return `true` if this token has any one of the given [types].
@@ skipping 450 matching lines @@
 
   void set precedingComments(CommentToken comment) {
     _precedingComment = comment;
     _setCommentParent(_precedingComment);
   }
 
   @override
   Token copy() =>
       new TokenWithComment(type, offset, copyComments(precedingComments));
 }