Dangling comment reference cleanup in analyzer.

pkg/analyzer/lib/src/dart/ast/token.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 analyzer.src.dart.ast.token;
 
 import 'package:analyzer/dart/ast/token.dart';
 import 'package:analyzer/src/generated/java_engine.dart';
 
 /**
@@ skipping 27 matching lines @@
 class BeginTokenWithComment extends BeginToken implements TokenWithComment {
   /**
    * The first comment in the list of comments that precede this token.
    */
   @override
   CommentToken _precedingComment;
 
   /**
    * Initialize a newly created token to have the given [type] at the given
    * [offset] and to be preceded by the comments reachable from the given
-   * [comment].
+   * [_precedingComment].
    */
   BeginTokenWithComment(TokenType type, int offset, this._precedingComment)
       : super(type, offset) {
     _setCommentParent(_precedingComment);
   }
 
   @override
   CommentToken get precedingComments => _precedingComment;
 
   @override
@@ skipping 108 matching lines @@
 class KeywordTokenWithComment extends KeywordToken implements TokenWithComment {
   /**
    * The first comment in the list of comments that precede this token.
    */
   @override
   CommentToken _precedingComment;
 
   /**
    * Initialize a newly created token to to represent the given [keyword] at the
    * given [offset] and to be preceded by the comments reachable from the given
-   * [comment].
+   * [_precedingComment].
    */
   KeywordTokenWithComment(Keyword keyword, int offset, this._precedingComment)
       : super(keyword, offset) {
     _setCommentParent(_precedingComment);
   }
 
   @override
   CommentToken get precedingComments => _precedingComment;
 
   void set precedingComments(CommentToken comment) {
@@ skipping 376 matching lines @@
   CommentToken get precedingComments => _precedingComment;
 
   void set precedingComments(CommentToken comment) {
     _precedingComment = comment;
     _setCommentParent(_precedingComment);
   }
 
   @override
   Token copy() => new TokenWithComment(type, offset, precedingComments);
 }