Mark some unused code as being deprecated

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.
 
 library analyzer.src.generated.parser;
 
 import 'dart:collection';
 import "dart:math" as math;
 
 import 'package:analyzer/dart/ast/ast.dart';
@@ skipping 509 matching lines @@
   FinalConstVarOrType(this.keyword, this.type);
 }
 
 /**
  * A dispatcher that will invoke the right parse method when re-parsing a
  * specified child of the visited node. All of the methods in this class assume
  * that the parser is positioned to parse the replacement for the node. All of
  * the methods will throw an [IncrementalParseException] if the node could not
  * be parsed for some reason.
  */
+@deprecated
 class IncrementalParseDispatcher implements AstVisitor<AstNode> {
   /**
    * The parser used to parse the replacement for the node.
    */
   final Parser _parser;
 
   /**
    * The node that is to be replaced.
    */
   final AstNode _oldNode;
@@ skipping 1117 matching lines @@
   AstNode _notAChild(AstNode node) {
     throw new IncrementalParseException.con1(
         "Internal error: the visited node (a ${node.runtimeType}) was not the parent of the node to be replaced (a ${_oldNode.runtimeType})");
   }
 }
 
 /**
  * An exception that occurred while attempting to parse a replacement for a
  * specified node in an existing AST structure.
  */
+@deprecated
 class IncrementalParseException extends RuntimeException {
   /**
    * Initialize a newly created exception to have no message and to be its own
    * cause.
    */
   IncrementalParseException() : super();
 
   /**
    * Initialize a newly created exception to have the given [message] and to be
    * its own cause.
    */
   IncrementalParseException.con1(String message) : super(message: message);
 
   /**
    * Initialize a newly created exception to have no message and to have the
    * given [cause].
    */
   IncrementalParseException.con2(Exception cause) : super(cause: cause);
 }
 
 /**
  * An object used to re-parse a single AST structure within a larger AST
  * structure.
  */
+@deprecated
 class IncrementalParser {
   /**
    * The source being parsed.
    */
   final Source _source;
 
   /**
    * A map from old tokens to new tokens used during the cloning process.
    */
   final TokenMap _tokenMap;
@@ skipping 151 matching lines @@
 }
 
 /**
  * A visitor capable of inferring the correct parser state for incremental
  * parsing.  This visitor visits each parent/child relationship in the chain of
  * ancestors of the node to be replaced (starting with the root of the parse
  * tree), updating the parser to the correct state for parsing the child of the
  * given parent.  Once it has visited all of these relationships, the parser
  * will be in the correct state for reparsing the node to be replaced.
  */
+@deprecated
 class IncrementalParseStateBuilder extends SimpleAstVisitor {
   // TODO(paulberry): add support for other pieces of parser state (_inAsync,
   // _inGenerator, _inLoop, and _inSwitch).  Note that _inLoop and _inSwitch
   // only affect error message generation.
 
   /**
    * The parser whose state should be built.
    */
   final Parser _parser;
 
@@ skipping 71 matching lines @@
       _parser._inInitializer = false;
     }
   }
 }
 
 /**
  * An exception indicating that an AST node cannot be re-parsed because there is
  * not enough context to know how to re-parse the node. Clients can attempt to
  * re-parse the parent of the node.
  */
+@deprecated
 class InsufficientContextException extends IncrementalParseException {
   /**
    * Initialize a newly created exception to have no message and to be its own
    * cause.
    */
   InsufficientContextException() : super();
 
   /**
    * Initialize a newly created exception to have the given [message] and to be
    * its own cause.
@@ skipping 7971 matching lines @@
    */
   const ParserErrorCode(String name, String message, [String correction])
       : super(name, message, correction);
 
   @override
   ErrorSeverity get errorSeverity => ErrorSeverity.ERROR;
 
   @override
   ErrorType get type => ErrorType.SYNTACTIC_ERROR;
 }