Deprecate analysis option "cacheSize".

pkg/analyzer/lib/src/generated/engine.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.engine;
 
 import 'dart:async';
 import 'dart:collection';
 
 import 'package:analyzer/dart/ast/ast.dart';
@@ skipping 1043 matching lines @@
  * context.
  */
 abstract class AnalysisOptions {
   /**
    * Function that returns `true` if analysis is to parse and analyze function
    * bodies for a given source.
    */
   AnalyzeFunctionBodiesPredicate get analyzeFunctionBodiesPredicate;
 
   /**
-   * Return the maximum number of sources for which AST structures should be
+   * DEPRECATED: Return the maximum number of sources for which AST structures should be
    * kept in the cache.
+   *
+   * This setting no longer has any effect.
    */
+  @deprecated
   int get cacheSize;
 
   /**
    * Return `true` if analysis is to generate dart2js related hint results.
    */
   bool get dart2jsHint;
 
   /**
    * Return `true` if cache flushing should be disabled.  Setting this option to
    * `true` can improve analysis speed at the expense of memory usage.  It may
@@ skipping 141 matching lines @@
    */
   void setCrossContextOptionsFrom(AnalysisOptions options);
 }
 
 /**
  * A set of analysis options used to control the behavior of an analysis
  * context.
  */
 class AnalysisOptionsImpl implements AnalysisOptions {
   /**
-   * The maximum number of sources for which data should be kept in the cache.
+   * DEPRECATED: The maximum number of sources for which data should be kept in the cache.
+   *
+   * This constant no longer has any effect.
    */
+  @deprecated
   static const int DEFAULT_CACHE_SIZE = 64;
 
   static const int ENABLE_ASSERT_FLAG = 0x01;
   static const int ENABLE_GENERIC_METHODS_FLAG = 0x02;
   static const int ENABLE_STRICT_CALL_CHECKS_FLAG = 0x04;
   static const int ENABLE_STRONG_MODE_FLAG = 0x08;
   static const int ENABLE_STRONG_MODE_HINTS_FLAG = 0x10;
   static const int ENABLE_SUPER_MIXINS_FLAG = 0x20;
 
   /**
    * The default list of non-nullable type names.
    */
   static const List<String> NONNULLABLE_TYPES = const <String>[];
 
   /**
    * A predicate indicating whether analysis is to parse and analyze function
    * bodies.
    */
   AnalyzeFunctionBodiesPredicate _analyzeFunctionBodiesPredicate =
       _analyzeAllFunctionBodies;
 
   @override
+  @deprecated
   int cacheSize = DEFAULT_CACHE_SIZE;
 
   @override
   bool dart2jsHint = false;
 
   @override
   bool enableAssertInitializer = false;
 
   @override
   bool enableAssertMessage = false;
@@ skipping 1424 matching lines @@
    * The data that was created from the source.
    */
   final E data;
 
   /**
    * Initialize a newly created holder to associate the given [data] with the
    * given [modificationTime].
    */
   TimestampedData(this.modificationTime, this.data);
 }