New analyzer_experimental snapshot.

pkg/analyzer_experimental/lib/src/generated/engine.dart

 // This code was auto-generated, is not intended to be edited, and is subject to
 // significant change. Please see the README file for more information.
 library engine;
 import 'dart:collection' show HasNextIterator;
 import 'java_core.dart';
 import 'java_engine.dart';
 import 'instrumentation.dart';
 import 'error.dart';
 import 'source.dart';
 import 'scanner.dart' show Token, CharBufferScanner, StringScanner;
 import 'ast.dart';
 import 'parser.dart' show Parser;
 import 'sdk.dart' show DartSdk;
 import 'element.dart';
 import 'resolver.dart';
 import 'html.dart' show XmlTagNode, XmlAttributeNode, RecursiveXmlVisitor, HtmlScanner, HtmlScanResult, HtmlParser, HtmlParseResult, HtmlUnit;
 /**
- * The unique instance of the class {@code AnalysisEngine} serves as the entry point for the
+ * The unique instance of the class `AnalysisEngine` serves as the entry point for the
  * functionality provided by the analysis engine.
  * @coverage dart.engine
  */
 class AnalysisEngine {
 
   /**
    * The suffix used for Dart source files.
    */
   static String SUFFIX_DART = "dart";
 
@@ skipping 12 matching lines @@
    */
   static AnalysisEngine _UniqueInstance = new AnalysisEngine();
 
   /**
    * Return the unique instance of this class.
    * @return the unique instance of this class
    */
   static AnalysisEngine get instance => _UniqueInstance;
 
   /**
-   * Return {@code true} if the given file name is assumed to contain Dart source code.
+   * Return `true` if the given file name is assumed to contain Dart source code.
    * @param fileName the name of the file being tested
-   * @return {@code true} if the given file name is assumed to contain Dart source code
+   * @return `true` if the given file name is assumed to contain Dart source code
    */
   static bool isDartFileName(String fileName) {
     if (fileName == null) {
       return false;
     }
     return javaStringEqualsIgnoreCase(FileNameUtilities.getExtension(fileName), SUFFIX_DART);
   }
 
   /**
-   * Return {@code true} if the given file name is assumed to contain HTML.
+   * Return `true` if the given file name is assumed to contain HTML.
    * @param fileName the name of the file being tested
-   * @return {@code true} if the given file name is assumed to contain HTML
+   * @return `true` if the given file name is assumed to contain HTML
    */
   static bool isHtmlFileName(String fileName) {
     if (fileName == null) {
       return false;
     }
     String extension = FileNameUtilities.getExtension(fileName);
     return javaStringEqualsIgnoreCase(extension, SUFFIX_HTML) || javaStringEqualsIgnoreCase(extension, SUFFIX_HTM);
   }
 
   /**
@@ skipping 23 matching lines @@
    * Set the logger that should receive information about errors within the analysis engine to the
    * given logger.
    * @param logger the logger that should receive information about errors within the analysis
    * engine
    */
   void set logger(Logger logger2) {
     this._logger = logger2 == null ? Logger.NULL : logger2;
   }
 }
 /**
- * The interface {@code AnalysisContext} defines the behavior of objects that represent a context in
+ * The interface `AnalysisContext` defines the behavior of objects that represent a context in
  * which a single analysis can be performed and incrementally maintained. The context includes such
  * information as the version of the SDK being analyzed against as well as the package-root used to
- * resolve 'package:' URI's. (Both of which are known indirectly through the {@link SourceFactorysource factory}.)
- * <p>
+ * resolve 'package:' URI's. (Both of which are known indirectly through the [SourceFactorysource factory].)
+ *
  * An analysis context also represents the state of the analysis, which includes knowing which
  * sources have been included in the analysis (either directly or indirectly) and the results of the
- * analysis. Sources must be added and removed from the context using the method{@link #applyChanges(ChangeSet)}, which is also used to notify the context when sources have been
+ * analysis. Sources must be added and removed from the context using the method[applyChanges], which is also used to notify the context when sources have been
  * modified and, consequently, previously known results might have been invalidated.
- * <p>
+ *
  * There are two ways to access the results of the analysis. The most common is to use one of the
  * 'get' methods to access the results. The 'get' methods have the advantage that they will always
  * return quickly, but have the disadvantage that if the results are not currently available they
  * will return either nothing or in some cases an incomplete result. The second way to access
  * results is by using one of the 'compute' methods. The 'compute' methods will always attempt to
  * compute the requested results but might block the caller for a significant period of time.
- * <p>
+ *
  * When results have been invalidated, have never been computed (as is the case for newly added
  * sources), or have been removed from the cache, they are <b>not</b> automatically recreated. They
  * will only be recreated if one of the 'compute' methods is invoked.
- * <p>
+ *
  * However, this is not always acceptable. Some clients need to keep the analysis results
  * up-to-date. For such clients there is a mechanism that allows them to incrementally perform
  * needed analysis and get notified of the consequent changes to the analysis results. This
- * mechanism is realized by the method {@link #performAnalysisTask()}.
- * <p>
+ * mechanism is realized by the method [performAnalysisTask].
+ *
  * Analysis engine allows for having more than one context. This can be used, for example, to
  * perform one analysis based on the state of files on disk and a separate analysis based on the
  * state of those files in open editors. It can also be used to perform an analysis based on a
  * proposed future state, such as the state after a refactoring.
  */
 abstract class AnalysisContext {
 
   /**
    * Apply the changes specified by the given change set to this context. Any analysis results that
    * have been invalidated by these changes will be removed.
    * @param changeSet a description of the changes that are to be applied
    */
   void applyChanges(ChangeSet changeSet);
 
   /**
    * Return the documentation comment for the given element as it appears in the original source
-   * (complete with the beginning and ending delimiters), or {@code null} if the element does not
+   * (complete with the beginning and ending delimiters), or `null` if the element does not
    * have a documentation comment associated with it. This can be a long-running operation if the
    * information needed to access the comment is not cached.
    * @param element the element whose documentation comment is to be returned
    * @return the element's documentation comment
    * @throws AnalysisException if the documentation comment could not be determined because the
    * analysis could not be performed
    */
   String computeDocumentationComment(Element element);
 
   /**
@@ skipping 16 matching lines @@
    * them.
    * @param source the source defining the HTML file whose element model is to be returned
    * @return the element model corresponding to the HTML file defined by the given source
    * @throws AnalysisException if the element model could not be determined because the analysis
    * could not be performed
    * @see #getHtmlElement(Source)
    */
   HtmlElement computeHtmlElement(Source source);
 
   /**
-   * Return the kind of the given source, computing it's kind if it is not already known. Return{@link SourceKind#UNKNOWN} if the source is not contained in this context.
+   * Return the kind of the given source, computing it's kind if it is not already known. Return[SourceKind#UNKNOWN] if the source is not contained in this context.
    * @param source the source whose kind is to be returned
    * @return the kind of the given source
    * @see #getKindOf(Source)
    */
   SourceKind computeKindOf(Source source);
 
   /**
    * Return the element model corresponding to the library defined by the given source. If the
    * element model does not yet exist it will be created. The process of creating an element model
    * for a library can long-running, depending on the size of the library and the number of
    * libraries that are imported into it that also need to have a model built for them.
    * @param source the source defining the library whose element model is to be returned
    * @return the element model corresponding to the library defined by the given source
    * @throws AnalysisException if the element model could not be determined because the analysis
    * could not be performed
    * @see #getLibraryElement(Source)
    */
   LibraryElement computeLibraryElement(Source source);
 
   /**
-   * Return the line information for the given source, or {@code null} if the source is not of a
+   * Return the line information for the given source, or `null` if the source is not of a
    * recognized kind (neither a Dart nor HTML file). If the line information was not previously
    * known it will be created. The line information is used to map offsets from the beginning of the
    * source to line and column pairs.
    * @param source the source whose line information is to be returned
    * @return the line information for the given source
    * @throws AnalysisException if the line information could not be determined because the analysis
    * could not be performed
    * @see #getLineInfo(Source)
    */
   LineInfo computeLineInfo(Source source);
 
   /**
    * Create a new context in which analysis can be performed. Any sources in the specified container
    * will be removed from this context and added to the newly created context.
    * @param container the container containing sources that should be removed from this context and
    * added to the returned context
    * @return the analysis context that was created
    */
   AnalysisContext extractContext(SourceContainer container);
 
   /**
    * Return the set of analysis options controlling the behavior of this context.
    * @return the set of analysis options controlling the behavior of this context
    */
   AnalysisOptions get analysisOptions;
 
   /**
-   * Return the element referenced by the given location, or {@code null} if the element is not
+   * Return the element referenced by the given location, or `null` if the element is not
    * immediately available or if there is no element with the given location. The latter condition
    * can occur, for example, if the location describes an element from a different context or if the
    * element has been removed from this context as a result of some change since it was originally
    * obtained.
    * @param location the reference describing the element to be returned
    * @return the element referenced by the given location
    */
   Element getElement(ElementLocation location);
 
   /**
    * Return an analysis error info containing the array of all of the errors and the line info
    * associated with the given source. The array of errors will be empty if the source is not known
    * to this context or if there are no errors in the source. The errors contained in the array can
    * be incomplete.
    * @param source the source whose errors are to be returned
    * @return all of the errors associated with the given source and the line info
    * @see #computeErrors(Source)
    */
   AnalysisErrorInfo getErrors(Source source);
 
   /**
-   * Return the element model corresponding to the HTML file defined by the given source, or{@code null} if the source does not represent an HTML file, the element representing the file
+   * Return the element model corresponding to the HTML file defined by the given source, or`null` if the source does not represent an HTML file, the element representing the file
    * has not yet been created, or the analysis of the HTML file failed for some reason.
    * @param source the source defining the HTML file whose element model is to be returned
    * @return the element model corresponding to the HTML file defined by the given source
    * @see #computeHtmlElement(Source)
    */
   HtmlElement getHtmlElement(Source source);
 
   /**
    * Return the sources for the HTML files that reference the given compilation unit. If the source
    * does not represent a Dart source or is not known to this context, the returned array will be
    * empty. The contents of the array can be incomplete.
    * @param source the source referenced by the returned HTML files
    * @return the sources for the HTML files that reference the given compilation unit
    */
   List<Source> getHtmlFilesReferencing(Source source);
 
   /**
    * Return an array containing all of the sources known to this context that represent HTML files.
    * The contents of the array can be incomplete.
    * @return the sources known to this context that represent HTML files
    */
   List<Source> get htmlSources;
 
   /**
-   * Return the kind of the given source, or {@code null} if the kind is not known to this context.
+   * Return the kind of the given source, or `null` if the kind is not known to this context.
    * @param source the source whose kind is to be returned
    * @return the kind of the given source
    * @see #computeKindOf(Source)
    */
   SourceKind getKindOf(Source source);
 
   /**
    * Return an array containing all of the sources known to this context that represent the defining
    * compilation unit of a library that can be run within a browser. The sources that are returned
    * represent libraries that have a 'main' method and are either referenced by an HTML file or
@@ skipping 29 matching lines @@
   /**
    * Return the sources for the defining compilation units of any libraries that depend on the given
    * library. One library depends on another if it either imports or exports that library.
    * @param librarySource the source for the defining compilation unit of the library being depended
    * on
    * @return the sources for the libraries that depend on the given library
    */
   List<Source> getLibrariesDependingOn(Source librarySource);
 
   /**
-   * Return the element model corresponding to the library defined by the given source, or{@code null} if the element model does not currently exist or if the library cannot be analyzed
+   * Return the element model corresponding to the library defined by the given source, or`null` if the element model does not currently exist or if the library cannot be analyzed
    * for some reason.
    * @param source the source defining the library whose element model is to be returned
    * @return the element model corresponding to the library defined by the given source
    */
   LibraryElement getLibraryElement(Source source);
 
   /**
    * Return an array containing all of the sources known to this context that represent the defining
    * compilation unit of a library. The contents of the array can be incomplete.
    * @return the sources known to this context that represent the defining compilation unit of a
    * library
    */
   List<Source> get librarySources;
 
   /**
-   * Return the line information for the given source, or {@code null} if the line information is
+   * Return the line information for the given source, or `null` if the line information is
    * not known. The line information is used to map offsets from the beginning of the source to line
    * and column pairs.
    * @param source the source whose line information is to be returned
    * @return the line information for the given source
    * @see #computeLineInfo(Source)
    */
   LineInfo getLineInfo(Source source);
 
   /**
-   * Return a fully resolved AST for a single compilation unit within the given library, or{@code null} if the resolved AST is not already computed.
+   * Return a fully resolved AST for a single compilation unit within the given library, or`null` if the resolved AST is not already computed.
    * @param unitSource the source of the compilation unit
    * @param library the library containing the compilation unit
    * @return a fully resolved AST for the compilation unit
    * @see #resolveCompilationUnit(Source,LibraryElement)
    */
   CompilationUnit getResolvedCompilationUnit(Source unitSource, LibraryElement library);
 
   /**
-   * Return a fully resolved AST for a single compilation unit within the given library, or{@code null} if the resolved AST is not already computed.
+   * Return a fully resolved AST for a single compilation unit within the given library, or`null` if the resolved AST is not already computed.
    * @param unitSource the source of the compilation unit
    * @param librarySource the source of the defining compilation unit of the library containing the
    * compilation unit
    * @return a fully resolved AST for the compilation unit
    * @see #resolveCompilationUnit(Source,Source)
    */
   CompilationUnit getResolvedCompilationUnit2(Source unitSource, Source librarySource);
 
   /**
    * Return the source factory used to create the sources that can be analyzed in this context.
    * @return the source factory used to create the sources that can be analyzed in this context
    */
   SourceFactory get sourceFactory;
 
   /**
-   * Return {@code true} if the given source is known to be the defining compilation unit of a
+   * Return `true` if the given source is known to be the defining compilation unit of a
    * library that can be run on a client (references 'dart:html', either directly or indirectly).
-   * <p>
-   * <b>Note:</b> In addition to the expected case of returning {@code false} if the source is known
-   * to be a library that cannot be run on a client, this method will also return {@code false} if
+   *
+   * <b>Note:</b> In addition to the expected case of returning `false` if the source is known
+   * to be a library that cannot be run on a client, this method will also return `false` if
    * the source is not known to be a library or if we do not know whether it can be run on a client.
    * @param librarySource the source being tested
-   * @return {@code true} if the given source is known to be a library that can be run on a client
+   * @return `true` if the given source is known to be a library that can be run on a client
    */
   bool isClientLibrary(Source librarySource);
 
   /**
-   * Return {@code true} if the given source is known to be the defining compilation unit of a
+   * Return `true` if the given source is known to be the defining compilation unit of a
    * library that can be run on the server (does not reference 'dart:html', either directly or
    * indirectly).
-   * <p>
-   * <b>Note:</b> In addition to the expected case of returning {@code false} if the source is known
-   * to be a library that cannot be run on the server, this method will also return {@code false} if
+   *
+   * <b>Note:</b> In addition to the expected case of returning `false` if the source is known
+   * to be a library that cannot be run on the server, this method will also return `false` if
    * the source is not known to be a library or if we do not know whether it can be run on the
    * server.
    * @param librarySource the source being tested
-   * @return {@code true} if the given source is known to be a library that can be run on the server
+   * @return `true` if the given source is known to be a library that can be run on the server
    */
   bool isServerLibrary(Source librarySource);
 
   /**
    * Add the sources contained in the specified context to this context's collection of sources.
    * This method is called when an existing context's pubspec has been removed, and the contained
    * sources should be reanalyzed as part of this context.
    * @param context the context being merged
    */
   void mergeContext(AnalysisContext context);
 
   /**
    * Parse a single source to produce an AST structure. The resulting AST structure may or may not
    * be resolved, and may have a slightly different structure depending upon whether it is resolved.
    * @param source the source to be parsed
    * @return the AST structure representing the content of the source
    * @throws AnalysisException if the analysis could not be performed
    */
   CompilationUnit parseCompilationUnit(Source source);
 
   /**
    * Parse a single HTML source to produce an AST structure. The resulting HTML AST structure may or
    * may not be resolved, and may have a slightly different structure depending upon whether it is
    * resolved.
    * @param source the HTML source to be parsed
-   * @return the parse result (not {@code null})
+   * @return the parse result (not `null`)
    * @throws AnalysisException if the analysis could not be performed
    */
   HtmlUnit parseHtmlUnit(Source source);
 
   /**
    * Perform the next unit of work required to keep the analysis results up-to-date and return
    * information about the consequent changes to the analysis results. If there were no results the
    * returned array will be empty. If there are no more units of work required, then this method
-   * returns {@code null}. This method can be long running.
+   * returns `null`. This method can be long running.
    * @return an array containing notices of changes to the analysis results
    */
   List<ChangeNotice> performAnalysisTask();
 
   /**
    * Parse and resolve a single source within the given context to produce a fully resolved AST.
    * @param unitSource the source to be parsed and resolved
    * @param library the library containing the source to be resolved
    * @return the result of resolving the AST structure representing the content of the source in the
    * context of the given library
@@ skipping 25 matching lines @@
   /**
    * Set the set of analysis options controlling the behavior of this context to the given options.
    * Clients can safely assume that all necessary analysis results have been invalidated.
    * @param options the set of analysis options that will control the behavior of this context
    */
   void set analysisOptions(AnalysisOptions options);
 
   /**
    * Set the contents of the given source to the given contents and mark the source as having
    * changed. This has the effect of overriding the default contents of the source. If the contents
-   * are {@code null} the override is removed so that the default contents will be returned.
+   * are `null` the override is removed so that the default contents will be returned.
    * @param source the source whose contents are being overridden
    * @param contents the new contents of the source
    */
   void setContents(Source source, String contents);
 
   /**
    * Set the source factory used to create the sources that can be analyzed in this context to the
    * given source factory. Clients can safely assume that all analysis results have been
    * invalidated.
    * @param factory the source factory used to create the sources that can be analyzed in this
    * context
    */
   void set sourceFactory(SourceFactory factory);
 
   /**
-   * Given a collection of sources with content that has changed, return an {@link Iterable}identifying the sources that need to be resolved.
-   * @param changedSources an array of sources (not {@code null}, contains no {@code null}s)
+   * Given a collection of sources with content that has changed, return an [Iterable]identifying the sources that need to be resolved.
+   * @param changedSources an array of sources (not `null`, contains no `null`s)
    * @return An iterable returning the sources to be resolved
    */
   Iterable<Source> sourcesToResolve(List<Source> changedSources);
 }
 /**
- * The interface {@code AnalysisErrorInfo} contains the analysis errors and line information for the
+ * The interface `AnalysisErrorInfo` contains the analysis errors and line information for the
  * errors.
  */
 abstract class AnalysisErrorInfo {
 
   /**
-   * Return the errors that as a result of the analysis, or {@code null} if there were no errors.
+   * Return the errors that as a result of the analysis, or `null` if there were no errors.
    * @return the errors as a result of the analysis
    */
   List<AnalysisError> get errors;
 
   /**
-   * Return the line information associated with the errors, or {@code null} if there were no
+   * Return the line information associated with the errors, or `null` if there were no
    * errors.
    * @return the line information associated with the errors
    */
   LineInfo get lineInfo;
 }
 /**
- * Instances of the class {@code AnalysisException} represent an exception that occurred during the
+ * Instances of the class `AnalysisException` represent an exception that occurred during the
  * analysis of one or more sources.
  * @coverage dart.engine
  */
 class AnalysisException extends JavaException {
 
   /**
    * Initialize a newly created exception.
    */
   AnalysisException() : super() {
     _jtd_constructor_125_impl();
@@ skipping 26 matching lines @@
    * Initialize a newly created exception to have the given cause.
    * @param cause the underlying exception that caused this exception
    */
   AnalysisException.con3(Exception cause) : super.withCause(cause) {
     _jtd_constructor_128_impl(cause);
   }
   _jtd_constructor_128_impl(Exception cause) {
   }
 }
 /**
- * The interface {@code AnalysisOptions} defines the behavior of objects that provide access to a
+ * The interface `AnalysisOptions` defines the behavior of objects that provide access to a
  * set of analysis options used to control the behavior of an analysis context.
  */
 abstract class AnalysisOptions {
 
   /**
-   * Return {@code true} if analysis is to use strict mode. In strict mode, error reporting is based
+   * Return `true` if analysis is to use strict mode. In strict mode, error reporting is based
    * exclusively on the static type information.
-   * @return {@code true} if analysis is to use strict mode
+   * @return `true` if analysis is to use strict mode
    */
   bool get strictMode;
 }
 /**
- * The interface {@code ChangeNotice} defines the behavior of objects that represent a change to the
+ * The interface `ChangeNotice` defines the behavior of objects that represent a change to the
  * analysis results associated with a given source.
  * @coverage dart.engine
  */
 abstract class ChangeNotice implements AnalysisErrorInfo {
 
   /**
-   * Return the fully resolved AST that changed as a result of the analysis, or {@code null} if the
+   * Return the fully resolved AST that changed as a result of the analysis, or `null` if the
    * AST was not changed.
    * @return the fully resolved AST that changed as a result of the analysis
    */
   CompilationUnit get compilationUnit;
 
   /**
    * Return the source for which the result is being reported.
    * @return the source for which the result is being reported
    */
   Source get source;
 }
 /**
- * Instances of the class {@code ChangeSet} indicate what sources have been added, changed, or
+ * Instances of the class `ChangeSet` indicate what sources have been added, changed, or
  * removed.
  * @coverage dart.engine
  */
 class ChangeSet {
 
   /**
    * A list containing the sources that have been added.
    */
   List<Source> _added2 = new List<Source>();
 
@@ skipping 48 matching lines @@
    */
   List<Source> get removed => _removed2;
 
   /**
    * Return a list containing the source containers that were removed.
    * @return a list containing the source containers that were removed
    */
   List<SourceContainer> get removedContainers => _removedContainers;
 
   /**
-   * Return {@code true} if this change set does not contain any changes.
-   * @return {@code true} if this change set does not contain any changes
+   * Return `true` if this change set does not contain any changes.
+   * @return `true` if this change set does not contain any changes
    */
   bool isEmpty() => _added2.isEmpty && _changed2.isEmpty && _removed2.isEmpty && _removedContainers.isEmpty;
 
   /**
    * Record that the specified source has been removed.
    * @param source the source that was removed
    */
   void removed3(Source source) {
     if (source != null) {
       _removed2.add(source);
     }
   }
 
   /**
    * Record that the specified source container has been removed.
    * @param container the source container that was removed
    */
   void removedContainer(SourceContainer container) {
     if (container != null) {
       _removedContainers.add(container);
     }
   }
 }
 /**
- * The interface {@code DartEntry} defines the behavior of objects that maintain the information
+ * The interface `DartEntry` defines the behavior of objects that maintain the information
  * cached by an analysis context about an individual Dart file.
  * @coverage dart.engine
  */
 abstract class DartEntry implements SourceEntry {
 
   /**
    * The data descriptor representing the library element for the library. This data is only
    * available for Dart files that are the defining compilation unit of a library.
    */
   static final DataDescriptor<LibraryElement> ELEMENT = new DataDescriptor<LibraryElement>("DartEntry.ELEMENT");
@@ skipping 54 matching lines @@
   static final DataDescriptor<SourceKind> SOURCE_KIND = new DataDescriptor<SourceKind>("DartEntry.SOURCE_KIND");
 
   /**
    * Return all of the errors associated with the compilation unit that are currently cached.
    * @return all of the errors associated with the compilation unit
    */
   List<AnalysisError> get allErrors;
 
   /**
    * Return a valid parsed compilation unit, either an unresolved AST structure or the result of
-   * resolving the AST structure in the context of some library, or {@code null} if there is no
+   * resolving the AST structure in the context of some library, or `null` if there is no
    * parsed compilation unit available.
    * @return a valid parsed compilation unit
    */
   CompilationUnit get anyParsedCompilationUnit;
 
   /**
-   * Return the result of resolving the compilation unit as part of any library, or {@code null} if
+   * Return the result of resolving the compilation unit as part of any library, or `null` if
    * there is no cached resolved compilation unit.
    * @return any resolved compilation unit
    */
   CompilationUnit get anyResolvedCompilationUnit;
 
   /**
    * Return the state of the data represented by the given descriptor in the context of the given
    * library.
    * @param descriptor the descriptor representing the data whose state is to be returned
    * @param librarySource the source of the defining compilation unit of the library that is the
    * context for the data
    * @return the value of the data represented by the given descriptor and library
    */
   CacheState getState2(DataDescriptor<Object> descriptor, Source librarySource);
 
   /**
    * Return the value of the data represented by the given descriptor in the context of the given
-   * library, or {@code null} if the data represented by the descriptor is not in the cache.
+   * library, or `null` if the data represented by the descriptor is not in the cache.
    * @param descriptor the descriptor representing which data is to be returned
    * @param librarySource the source of the defining compilation unit of the library that is the
    * context for the data
    * @return the value of the data represented by the given descriptor and library
    */
   Object getValue2(DataDescriptor descriptor, Source librarySource);
   DartEntryImpl get writableCopy;
 }
 /**
- * Instances of the class {@code DartEntryImpl} implement a {@link DartEntry}.
+ * Instances of the class `DartEntryImpl` implement a [DartEntry].
  * @coverage dart.engine
  */
 class DartEntryImpl extends SourceEntryImpl implements DartEntry {
 
   /**
    * The state of the cached source kind.
    */
   CacheState _sourceKindState = CacheState.INVALID;
 
   /**
    * The kind of this source.
    */
   SourceKind _sourceKind = SourceKind.UNKNOWN;
 
   /**
    * The state of the cached parsed compilation unit.
    */
   CacheState _parsedUnitState = CacheState.INVALID;
 
   /**
-   * The parsed compilation unit, or {@code null} if the parsed compilation unit is not currently
+   * The parsed compilation unit, or `null` if the parsed compilation unit is not currently
    * cached.
    */
   CompilationUnit _parsedUnit;
 
   /**
    * The state of the cached parse errors.
    */
   CacheState _parseErrorsState = CacheState.INVALID;
 
   /**
-   * The errors produced while scanning and parsing the compilation unit, or {@code null} if the
+   * The errors produced while scanning and parsing the compilation unit, or `null` if the
    * errors are not currently cached.
    */
   List<AnalysisError> _parseErrors = AnalysisError.NO_ERRORS;
 
   /**
    * The state of the cached list of included parts.
    */
   CacheState _includedPartsState = CacheState.INVALID;
 
   /**
    * The list of parts included in the library, or an empty array if the list is not currently
    * cached. The list will be empty if the Dart file is a part rather than a library.
    */
   List<Source> _includedParts = Source.EMPTY_ARRAY;
 
   /**
    * The state of the cached list of referenced libraries.
    */
   CacheState _referencedLibrariesState = CacheState.INVALID;
 
   /**
    * The list of libraries referenced (imported or exported) by the library, or an empty array if
    * the list is not currently cached. The list will be empty if the Dart file is a part rather than
    * a library.
    */
   List<Source> _referencedLibraries = Source.EMPTY_ARRAY;
 
   /**
    * The information known as a result of resolving this compilation unit as part of the library
-   * that contains this unit. This field will never be {@code null}.
+   * that contains this unit. This field will never be `null`.
    */
   DartEntryImpl_ResolutionState _resolutionState = new DartEntryImpl_ResolutionState();
 
   /**
    * The state of the cached library element.
    */
   CacheState _elementState = CacheState.INVALID;
 
   /**
-   * The element representing the library, or {@code null} if the element is not currently cached.
+   * The element representing the library, or `null` if the element is not currently cached.
    */
   LibraryElement _element;
 
   /**
    * The state of the cached public namespace.
    */
   CacheState _publicNamespaceState = CacheState.INVALID;
 
   /**
-   * The public namespace of the library, or {@code null} if the namespace is not currently cached.
+   * The public namespace of the library, or `null` if the namespace is not currently cached.
    */
   Namespace _publicNamespace;
 
   /**
    * The state of the cached client/ server flag.
    */
   CacheState _clientServerState = CacheState.INVALID;
 
   /**
    * The state of the cached launchable flag.
    */
   CacheState _launchableState = CacheState.INVALID;
 
   /**
-   * An integer holding bit masks such as {@link #LAUNCHABLE} and {@link #CLIENT_CODE}.
+   * An integer holding bit masks such as [LAUNCHABLE] and [CLIENT_CODE].
    */
   int _bitmask = 0;
 
   /**
    * Mask indicating that this library is launchable: that the file has a main method.
    */
   static int _LAUNCHABLE = 1 << 1;
 
   /**
    * Mask indicating that the library is client code: that the library depends on the html library.
@@ skipping 351 matching lines @@
     } else if (identical(descriptor, DartEntry.SOURCE_KIND)) {
       _sourceKind = value as SourceKind;
       _sourceKindState = CacheState.VALID;
     } else {
       super.setValue(descriptor, value);
     }
   }
 
   /**
    * Set the value of the data represented by the given descriptor in the context of the given
-   * library to the given value, and set the state of that data to {@link CacheState#VALID}.
+   * library to the given value, and set the state of that data to [CacheState#VALID].
    * @param descriptor the descriptor representing which data is to have its value set
    * @param librarySource the source of the defining compilation unit of the library that is the
    * context for the data
    * @param value the new value of the data represented by the given descriptor and library
    */
   void setValue2(DataDescriptor descriptor, Source librarySource, Object value) {
     DartEntryImpl_ResolutionState state = getOrCreateResolutionState(librarySource);
     if (identical(descriptor, DartEntry.RESOLUTION_ERRORS)) {
       state._resolutionErrors = value == null ? AnalysisError.NO_ERRORS : (value as List<AnalysisError>);
       state._resolutionErrorsState = CacheState.VALID;
@@ skipping 20 matching lines @@
     _element = other._element;
     _publicNamespaceState = other._publicNamespaceState;
     _publicNamespace = other._publicNamespace;
     _clientServerState = other._clientServerState;
     _launchableState = other._launchableState;
     _bitmask = other._bitmask;
   }
 
   /**
    * Return a resolution state for the specified library, creating one as necessary.
-   * @param librarySource the library source (not {@code null})
-   * @return the resolution state (not {@code null})
+   * @param librarySource the library source (not `null`)
+   * @return the resolution state (not `null`)
    */
   DartEntryImpl_ResolutionState getOrCreateResolutionState(Source librarySource2) {
     DartEntryImpl_ResolutionState state = _resolutionState;
     if (state._librarySource == null) {
       state._librarySource = librarySource2;
       return state;
     }
     while (state._librarySource != librarySource2) {
       if (state._nextState == null) {
         DartEntryImpl_ResolutionState newState = new DartEntryImpl_ResolutionState();
@@ skipping 17 matching lines @@
   int updatedValue2(CacheState state, int currentValue, int bitMask) {
     if (identical(state, CacheState.VALID)) {
       throw new IllegalArgumentException("Use setValue() to set the state to VALID");
     } else if (identical(state, CacheState.IN_PROCESS)) {
       return currentValue;
     }
     return currentValue &= ~bitMask;
   }
 }
 /**
- * Instances of the class {@code ResolutionState} represent the information produced by resolving
+ * Instances of the class `ResolutionState` represent the information produced by resolving
  * a compilation unit as part of a specific library.
  */
 class DartEntryImpl_ResolutionState {
 
   /**
-   * The next resolution state or {@code null} if none.
+   * The next resolution state or `null` if none.
    */
   DartEntryImpl_ResolutionState _nextState;
 
   /**
    * The source for the defining compilation unit of the library that contains this unit. If this
    * unit is the defining compilation unit for it's library, then this will be the source for this
    * unit.
    */
   Source _librarySource;
 
   /**
    * The state of the cached resolved compilation unit.
    */
   CacheState _resolvedUnitState = CacheState.INVALID;
 
   /**
-   * The resolved compilation unit, or {@code null} if the resolved compilation unit is not
+   * The resolved compilation unit, or `null` if the resolved compilation unit is not
    * currently cached.
    */
   CompilationUnit _resolvedUnit;
 
   /**
    * The state of the cached resolution errors.
    */
   CacheState _resolutionErrorsState = CacheState.INVALID;
 
   /**
-   * The errors produced while resolving the compilation unit, or {@code null} if the errors are
+   * The errors produced while resolving the compilation unit, or `null` if the errors are
    * not currently cached.
    */
   List<AnalysisError> _resolutionErrors = AnalysisError.NO_ERRORS;
 
   /**
    * Set this state to be exactly like the given state, recursively copying the next state as
    * necessary.
    * @param other the state to be copied
    */
   void copyFrom(DartEntryImpl_ResolutionState other) {
@@ skipping 28 matching lines @@
   void recordResolutionError() {
     _nextState = null;
     _librarySource = null;
     _resolvedUnitState = CacheState.ERROR;
     _resolvedUnit = null;
     _resolutionErrorsState = CacheState.ERROR;
     _resolutionErrors = AnalysisError.NO_ERRORS;
   }
 }
 /**
- * Instances of the class {@code DataDescriptor} are immutable constants representing data that can
+ * Instances of the class `DataDescriptor` are immutable constants representing data that can
  * be stored in the cache.
  */
 class DataDescriptor<E> {
 
   /**
    * The name of the descriptor, used for debugging purposes.
    */
   String _name;
 
   /**
    * Initialize a newly created descriptor to have the given name.
    * @param name the name of the descriptor
    */
   DataDescriptor(String name) {
     this._name = name;
   }
   String toString() => _name;
 }
 /**
- * The interface {@code HtmlEntry} defines the behavior of objects that maintain the information
+ * The interface `HtmlEntry` defines the behavior of objects that maintain the information
  * cached by an analysis context about an individual HTML file.
  * @coverage dart.engine
  */
 abstract class HtmlEntry implements SourceEntry {
 
   /**
    * The data descriptor representing the HTML element.
    */
   static final DataDescriptor<HtmlElement> ELEMENT = new DataDescriptor<HtmlElement>("HtmlEntry.ELEMENT");
 
@@ skipping 18 matching lines @@
   static final DataDescriptor<HtmlUnit> RESOLVED_UNIT = new DataDescriptor<HtmlUnit>("HtmlEntry.RESOLVED_UNIT");
 
   /**
    * Return all of the errors associated with the compilation unit that are currently cached.
    * @return all of the errors associated with the compilation unit
    */
   List<AnalysisError> get allErrors;
   HtmlEntryImpl get writableCopy;
 }
 /**
- * Instances of the class {@code HtmlEntryImpl} implement an {@link HtmlEntry}.
+ * Instances of the class `HtmlEntryImpl` implement an [HtmlEntry].
  * @coverage dart.engine
  */
 class HtmlEntryImpl extends SourceEntryImpl implements HtmlEntry {
 
   /**
    * The state of the cached parsed (but not resolved) HTML unit.
    */
   CacheState _parsedUnitState = CacheState.INVALID;
 
   /**
-   * The parsed HTML unit, or {@code null} if the parsed HTML unit is not currently cached.
+   * The parsed HTML unit, or `null` if the parsed HTML unit is not currently cached.
    */
   HtmlUnit _parsedUnit;
 
   /**
    * The state of the cached resolution errors.
    */
   CacheState _resolutionErrorsState = CacheState.INVALID;
 
   /**
-   * The errors produced while resolving the compilation unit, or {@code null} if the errors are not
+   * The errors produced while resolving the compilation unit, or `null` if the errors are not
    * currently cached.
    */
   List<AnalysisError> _resolutionErrors = AnalysisError.NO_ERRORS;
 
   /**
    * The state of the cached parsed and resolved HTML unit.
    */
   CacheState _resolvedUnitState = CacheState.INVALID;
 
   /**
-   * The resolved HTML unit, or {@code null} if the resolved HTML unit is not currently cached.
+   * The resolved HTML unit, or `null` if the resolved HTML unit is not currently cached.
    */
   HtmlUnit _resolvedUnit;
 
   /**
    * The state of the cached list of referenced libraries.
    */
   CacheState _referencedLibrariesState = CacheState.INVALID;
 
   /**
-   * The list of libraries referenced in the HTML, or {@code null} if the list is not currently
+   * The list of libraries referenced in the HTML, or `null` if the list is not currently
    * cached. Note that this list does not include libraries defined directly within the HTML file.
    */
   List<Source> _referencedLibraries = Source.EMPTY_ARRAY;
 
   /**
    * The state of the cached HTML element.
    */
   CacheState _elementState = CacheState.INVALID;
 
   /**
-   * The element representing the HTML file, or {@code null} if the element is not currently cached.
+   * The element representing the HTML file, or `null` if the element is not currently cached.
    */
   HtmlElement _element;
   List<AnalysisError> get allErrors {
     List<AnalysisError> errors = new List<AnalysisError>();
     for (AnalysisError error in _resolutionErrors) {
       errors.add(error);
     }
     if (errors.length == 0) {
       return AnalysisError.NO_ERRORS;
     }
@@ skipping 82 matching lines @@
     _referencedLibraries = other._referencedLibraries;
     _resolutionErrors = other._resolutionErrors;
     _resolutionErrorsState = other._resolutionErrorsState;
     _resolvedUnitState = other._resolvedUnitState;
     _resolvedUnit = other._resolvedUnit;
     _elementState = other._elementState;
     _element = other._element;
   }
 }
 /**
- * The interface {@code SourceEntry} defines the behavior of objects that maintain the information
+ * The interface `SourceEntry` defines the behavior of objects that maintain the information
  * cached by an analysis context about an individual source, no matter what kind of source it is.
- * <p>
+ *
  * Source entries should be treated as if they were immutable unless a writable copy of the entry
  * has been obtained and has not yet been made visible to other threads.
  * @coverage dart.engine
  */
 abstract class SourceEntry {
 
   /**
    * The data descriptor representing the line information.
    */
   static final DataDescriptor<LineInfo> LINE_INFO = new DataDescriptor<LineInfo>("SourceEntry.LINE_INFO");
 
   /**
-   * Return the kind of the source, or {@code null} if the kind is not currently cached.
+   * Return the kind of the source, or `null` if the kind is not currently cached.
    * @return the kind of the source
    */
   SourceKind get kind;
 
   /**
    * Return the most recent time at which the state of the source matched the state represented by
    * this entry.
    * @return the modification time of this entry
    */
   int get modificationTime;
 
   /**
    * Return the state of the data represented by the given descriptor.
    * @param descriptor the descriptor representing the data whose state is to be returned
    * @return the state of the data represented by the given descriptor
    */
   CacheState getState(DataDescriptor<Object> descriptor);
 
   /**
-   * Return the value of the data represented by the given descriptor, or {@code null} if the data
+   * Return the value of the data represented by the given descriptor, or `null` if the data
    * represented by the descriptor is not in the cache.
    * @param descriptor the descriptor representing which data is to be returned
    * @return the value of the data represented by the given descriptor
    */
   Object getValue(DataDescriptor descriptor);
 
   /**
    * Return a new entry that is initialized to the same state as this entry but that can be
    * modified.
    * @return a writable copy of this entry
    */
   SourceEntryImpl get writableCopy;
 }
 /**
- * Instances of the abstract class {@code SourceEntryImpl} implement the behavior common to all{@link SourceEntry source entries}.
+ * Instances of the abstract class `SourceEntryImpl` implement the behavior common to all[SourceEntry source entries].
  * @coverage dart.engine
  */
 abstract class SourceEntryImpl implements SourceEntry {
 
   /**
    * The most recent time at which the state of the source matched the state represented by this
    * entry.
    */
   int _modificationTime = 0;
 
   /**
    * The state of the cached line information.
    */
   CacheState _lineInfoState = CacheState.INVALID;
 
   /**
-   * The line information computed for the source, or {@code null} if the line information is not
+   * The line information computed for the source, or `null` if the line information is not
    * currently cached.
    */
   LineInfo _lineInfo;
   int get modificationTime => _modificationTime;
   CacheState getState(DataDescriptor<Object> descriptor) {
     if (identical(descriptor, SourceEntry.LINE_INFO)) {
       return _lineInfoState;
     } else {
       throw new IllegalArgumentException("Invalid descriptor: ${descriptor}");
     }
@@ skipping 64 matching lines @@
   Object updatedValue(CacheState state, Object currentValue, Object defaultValue) {
     if (identical(state, CacheState.VALID)) {
       throw new IllegalArgumentException("Use setValue() to set the state to VALID");
     } else if (identical(state, CacheState.IN_PROCESS)) {
       return currentValue;
     }
     return defaultValue;
   }
 }
 /**
- * Instances of the class {@code AnalysisContextImpl} implement an {@link AnalysisContext analysis
- * context}.
+ * Instances of the class `AnalysisContextImpl` implement an [AnalysisContext analysis
+ * context].
  * @coverage dart.engine
  */
 class AnalysisContextImpl implements InternalAnalysisContext {
 
   /**
    * The set of analysis options controlling the behavior of this context.
    */
   AnalysisOptions _options = new AnalysisOptionsImpl();
 
   /**
@@ skipping 664 matching lines @@
     List<Source> librarySources = new List<Source>();
     for (Source source in changedSources) {
       if (identical(computeKindOf(source), SourceKind.LIBRARY)) {
         librarySources.add(source);
       }
     }
     return librarySources;
   }
 
   /**
-   * Return a list of the sources that would be processed by {@link #performAnalysisTask()}. This
+   * Return a list of the sources that would be processed by [performAnalysisTask]. This
    * method is intended to be used for testing purposes only.
-   * @return a list of the sources that would be processed by {@link #performAnalysisTask()}
+   * @return a list of the sources that would be processed by [performAnalysisTask]
    */
   List<Source> get sourcesNeedingProcessing {
     List<Source> sources = new List<Source>();
     {
       for (MapEntry<Source, SourceEntry> entry in getMapEntrySet(_sourceMap)) {
         SourceEntry sourceEntry = entry.getValue();
         if (sourceEntry is DartEntry) {
           DartEntry dartEntry = sourceEntry as DartEntry;
           CacheState parsedUnitState = dartEntry.getState(DartEntry.PARSED_UNIT);
           CacheState elementState = dartEntry.getState(DartEntry.ELEMENT);
           if (identical(parsedUnitState, CacheState.INVALID) || identical(elementState, CacheState.INVALID)) {
             sources.add(entry.getKey());
           }
         } else if (sourceEntry is HtmlEntry) {
           HtmlEntry htmlEntry = sourceEntry as HtmlEntry;
           CacheState parsedUnitState = htmlEntry.getState(HtmlEntry.PARSED_UNIT);
           CacheState resolvedUnitState = htmlEntry.getState(HtmlEntry.RESOLVED_UNIT);
           if (identical(parsedUnitState, CacheState.INVALID) || identical(resolvedUnitState, CacheState.INVALID)) {
             sources.add(entry.getKey());
           }
         }
       }
     }
     return sources;
   }
 
   /**
    * Record that the given source was just accessed for some unspecified purpose.
-   * <p>
-   * Note: This method must only be invoked while we are synchronized on {@link #cacheLock}.
+   *
+   * Note: This method must only be invoked while we are synchronized on [cacheLock].
    * @param source the source that was accessed
    */
   void accessed(Source source) {
     if (_recentlyUsed.contains(source)) {
       _recentlyUsed.remove(source);
       _recentlyUsed.add(source);
       return;
     }
     if (_cacheRemovalCount == 0 && _recentlyUsed.length >= _MAX_CACHE_SIZE) {
       Source removedSource = _recentlyUsed.removeAt(0);
@@ skipping 10 matching lines @@
           dartCopy.setState2(DartEntry.RESOLVED_UNIT, librarySource, CacheState.FLUSHED);
         }
         _sourceMap[removedSource] = dartCopy;
       }
     }
     _recentlyUsed.add(source);
   }
 
   /**
    * Add all of the sources contained in the given source container to the given list of sources.
-   * <p>
-   * Note: This method must only be invoked while we are synchronized on {@link #cacheLock}.
+   *
+   * Note: This method must only be invoked while we are synchronized on [cacheLock].
    * @param sources the list to which sources are to be added
    * @param container the source container containing the sources to be added to the list
    */
   void addSourcesInContainer(List<Source> sources, SourceContainer container) {
     for (Source source in _sourceMap.keys.toSet()) {
       if (container.contains(source)) {
         sources.add(source);
       }
     }
   }
 
   /**
-   * Return {@code true} if the given array of sources contains the given source.
+   * Return `true` if the given array of sources contains the given source.
    * @param sources the sources being searched
    * @param targetSource the source being searched for
-   * @return {@code true} if the given source is in the array
+   * @return `true` if the given source is in the array
    */
   bool contains(List<Source> sources, Source targetSource) {
     for (Source source in sources) {
       if (source == targetSource) {
         return true;
       }
     }
     return false;
   }
 
   /**
-   * Return {@code true} if the given array of sources contains any of the given target sources.
+   * Return `true` if the given array of sources contains any of the given target sources.
    * @param sources the sources being searched
    * @param targetSources the sources being searched for
-   * @return {@code true} if any of the given target sources are in the array
+   * @return `true` if any of the given target sources are in the array
    */
   bool containsAny(List<Source> sources, List<Source> targetSources) {
     for (Source targetSource in targetSources) {
       if (contains(sources, targetSource)) {
         return true;
       }
     }
     return false;
   }
 
   /**
    * Create a source information object suitable for the given source. Return the source information
-   * object that was created, or {@code null} if the source should not be tracked by this context.
+   * object that was created, or `null` if the source should not be tracked by this context.
    * @param source the source for which an information object is being created
    * @return the source information object that was created
    */
   SourceEntry createSourceEntry(Source source) {
     String name = source.shortName;
     if (AnalysisEngine.isHtmlFileName(name)) {
       HtmlEntry htmlEntry = new HtmlEntryImpl();
       _sourceMap[source] = htmlEntry;
       return htmlEntry;
     } else {
       DartEntry dartEntry = new DartEntryImpl();
       _sourceMap[source] = dartEntry;
       return dartEntry;
     }
   }
 
   /**
-   * Disable flushing information from the cache until {@link #enableCacheRemoval()} has been
+   * Disable flushing information from the cache until [enableCacheRemoval] has been
    * called.
    */
   void disableCacheRemoval() {
     _cacheRemovalCount++;
   }
 
   /**
    * Re-enable flushing information from the cache.
    */
   void enableCacheRemoval() {
@@ skipping 16 matching lines @@
             dartCopy.setState2(DartEntry.RESOLVED_UNIT, librarySource, CacheState.FLUSHED);
           }
           _sourceMap[removedSource] = dartCopy;
         }
       }
     }
   }
 
   /**
    * Search the compilation units that are part of the given library and return the element
-   * representing the compilation unit with the given source. Return {@code null} if there is no
+   * representing the compilation unit with the given source. Return `null` if there is no
    * such compilation unit.
    * @param libraryElement the element representing the library being searched through
    * @param unitSource the source for the compilation unit whose element is to be returned
    * @return the element representing the compilation unit
    */
   CompilationUnitElement find(LibraryElement libraryElement, Source unitSource) {
     CompilationUnitElement element = libraryElement.definingCompilationUnit;
     if (element.source == unitSource) {
       return element;
     }
     for (CompilationUnitElement partElement in libraryElement.parts) {
       if (partElement.source == unitSource) {
         return partElement;
       }
     }
     return null;
   }
 
   /**
-   * Return the compilation unit information associated with the given source, or {@code null} if
+   * Return the compilation unit information associated with the given source, or `null` if
    * the source is not known to this context. This method should be used to access the compilation
    * unit information rather than accessing the compilation unit map directly because sources in the
    * SDK are implicitly part of every analysis context and are therefore only added to the map when
    * first accessed.
-   * <p>
-   * <b>Note:</b> This method must only be invoked while we are synchronized on {@link #cacheLock}.
+   *
+   * <b>Note:</b> This method must only be invoked while we are synchronized on [cacheLock].
    * @param source the source for which information is being sought
    * @return the compilation unit information associated with the given source
    */
   DartEntry getDartEntry(Source source) {
     SourceEntry sourceEntry = getSourceEntry(source);
     if (sourceEntry == null) {
       sourceEntry = new DartEntryImpl();
       _sourceMap[source] = sourceEntry;
       return sourceEntry as DartEntry;
     } else if (sourceEntry is DartEntry) {
       return sourceEntry as DartEntry;
     }
     return null;
   }
 
   /**
-   * Return the HTML unit information associated with the given source, or {@code null} if the
+   * Return the HTML unit information associated with the given source, or `null` if the
    * source is not known to this context. This method should be used to access the HTML unit
    * information rather than accessing the HTML unit map directly because sources in the SDK are
    * implicitly part of every analysis context and are therefore only added to the map when first
    * accessed.
-   * <p>
-   * <b>Note:</b> This method must only be invoked while we are synchronized on {@link #cacheLock}.
+   *
+   * <b>Note:</b> This method must only be invoked while we are synchronized on [cacheLock].
    * @param source the source for which information is being sought
    * @return the HTML unit information associated with the given source
    */
   HtmlEntry getHtmlEntry(Source source) {
     SourceEntry sourceEntry = getSourceEntry(source);
     if (sourceEntry == null) {
       sourceEntry = new HtmlEntryImpl();
       _sourceMap[source] = sourceEntry;
       return sourceEntry as HtmlEntry;
     } else if (sourceEntry is HtmlEntry) {
@@ skipping 25 matching lines @@
   ChangeNoticeImpl getNotice(Source source) {
     ChangeNoticeImpl notice = _pendingNotices[source];
     if (notice == null) {
       notice = new ChangeNoticeImpl(source);
       _pendingNotices[source] = notice;
     }
     return notice;
   }
 
   /**
-   * Return the cache entry associated with the given source, or {@code null} if there is no entry
+   * Return the cache entry associated with the given source, or `null` if there is no entry
    * associated with the source.
    * @param source the source for which a cache entry is being sought
    * @return the source cache entry associated with the given source
    */
   SourceEntry getReadableSourceEntry(Source source) {
     {
       return _sourceMap[source];
     }
   }
 
   /**
-   * Return the source information associated with the given source, or {@code null} if the source
+   * Return the source information associated with the given source, or `null` if the source
    * is not known to this context. This method should be used to access the source information
    * rather than accessing the source map directly because sources in the SDK are implicitly part of
    * every analysis context and are therefore only added to the map when first accessed.
-   * <p>
-   * <b>Note:</b> This method must only be invoked while we are synchronized on {@link #cacheLock}.
+   *
+   * <b>Note:</b> This method must only be invoked while we are synchronized on [cacheLock].
    * @param source the source for which information is being sought
    * @return the source information associated with the given source
    */
   SourceEntry getSourceEntry(Source source) {
     SourceEntry sourceEntry = _sourceMap[source];
     if (sourceEntry == null) {
       sourceEntry = createSourceEntry(source);
     }
     return sourceEntry;
   }
 
   /**
    * Return an array containing all of the sources known to this context that have the given kind.
    * @param kind the kind of sources to be returned
    * @return all of the sources known to this context that have the given kind
    */
   List<Source> getSources(SourceKind kind2) {
     List<Source> sources = new List<Source>();
     {
       for (MapEntry<Source, SourceEntry> entry in getMapEntrySet(_sourceMap)) {
         if (identical(entry.getValue().kind, kind2)) {
           sources.add(entry.getKey());
         }
       }
     }
     return new List.from(sources);
   }
 
   /**
-   * Return {@code true} if the given compilation unit has a part-of directive but no library
+   * Return `true` if the given compilation unit has a part-of directive but no library
    * directive.
    * @param unit the compilation unit being tested
-   * @return {@code true} if the compilation unit has a part-of directive
+   * @return `true` if the compilation unit has a part-of directive
    */
   bool hasPartOfDirective(CompilationUnit unit) {
     bool hasPartOf = false;
     for (Directive directive in unit.directives) {
       if (directive is PartOfDirective) {
         hasPartOf = true;
       } else if (directive is LibraryDirective) {
         return false;
       }
     }
@@ skipping 73 matching lines @@
     try {
       source.getContents(receiver);
     } catch (exception) {
       throw new AnalysisException.con3(exception);
     }
     return result;
   }
 
   /**
    * Invalidate all of the results computed by this context.
-   * <p>
-   * <b>Note:</b> This method must only be invoked while we are synchronized on {@link #cacheLock}.
+   *
+   * <b>Note:</b> This method must only be invoked while we are synchronized on [cacheLock].
    */
   void invalidateAllResults() {
     for (MapEntry<Source, SourceEntry> mapEntry in getMapEntrySet(_sourceMap)) {
       SourceEntry sourceEntry = mapEntry.getValue();
       if (sourceEntry is HtmlEntry) {
         HtmlEntryImpl htmlCopy = ((sourceEntry as HtmlEntry)).writableCopy;
         htmlCopy.setState(HtmlEntry.RESOLVED_UNIT, CacheState.INVALID);
         mapEntry.setValue(htmlCopy);
       } else if (sourceEntry is DartEntry) {
         DartEntryImpl dartCopy = ((sourceEntry as DartEntry)).writableCopy;
@@ skipping 21 matching lines @@
         if (partEntry != null) {
           DartEntryImpl dartCopy = partEntry.writableCopy;
           dartCopy.invalidateAllResolutionInformation();
           _sourceMap[unitSource] = dartCopy;
         }
       }
     }
   }
 
   /**
-   * Return {@code true} if this library is, or depends on, dart:html.
+   * Return `true` if this library is, or depends on, dart:html.
    * @param library the library being tested
    * @param visitedLibraries a collection of the libraries that have been visited, used to prevent
    * infinite recursion
-   * @return {@code true} if this library is, or depends on, dart:html
+   * @return `true` if this library is, or depends on, dart:html
    */
   bool isClient(LibraryElement library, Source htmlSource, Set<LibraryElement> visitedLibraries) {
     if (visitedLibraries.contains(library)) {
       return false;
     }
     if (library.source == htmlSource) {
       return true;
     }
     javaSetAdd(visitedLibraries, library);
     for (LibraryElement imported in library.importedLibraries) {
       if (isClient(imported, htmlSource, visitedLibraries)) {
         return true;
       }
     }
     for (LibraryElement exported in library.exportedLibraries) {
       if (isClient(exported, htmlSource, visitedLibraries)) {
         return true;
       }
     }
     return false;
   }
 
   /**
    * Perform a single analysis task.
-   * <p>
-   * <b>Note:</b> This method must only be invoked while we are synchronized on {@link #cacheLock}.
-   * @return {@code true} if work was done, implying that there might be more work to be done
+   *
+   * <b>Note:</b> This method must only be invoked while we are synchronized on [cacheLock].
+   * @return `true` if work was done, implying that there might be more work to be done
    */
   bool performSingleAnalysisTask() {
     for (MapEntry<Source, SourceEntry> entry in getMapEntrySet(_sourceMap)) {
       SourceEntry sourceEntry = entry.getValue();
       if (sourceEntry is DartEntry) {
         DartEntry dartEntry = sourceEntry as DartEntry;
         CacheState parsedUnitState = dartEntry.getState(DartEntry.PARSED_UNIT);
         if (identical(parsedUnitState, CacheState.INVALID)) {
           try {
             parseCompilationUnit(entry.getKey());
@@ skipping 129 matching lines @@
     HtmlScanner scanner = new HtmlScanner(source);
     try {
       source.getContents(scanner);
     } catch (exception) {
       throw new AnalysisException.con3(exception);
     }
     return scanner.result;
   }
 
   /**
-   * Create an entry for the newly added source. Return {@code true} if the new source is a Dart
+   * Create an entry for the newly added source. Return `true` if the new source is a Dart
    * file.
-   * <p>
-   * <b>Note:</b> This method must only be invoked while we are synchronized on {@link #cacheLock}.
+   *
+   * <b>Note:</b> This method must only be invoked while we are synchronized on [cacheLock].
    * @param source the source that has been added
-   * @return {@code true} if the new source is a Dart file
+   * @return `true` if the new source is a Dart file
    */
   bool sourceAvailable(Source source) {
     SourceEntry sourceEntry = _sourceMap[source];
     if (sourceEntry == null) {
       sourceEntry = createSourceEntry(source);
     }
     return sourceEntry is DartEntry;
   }
 
   /**
-   * <b>Note:</b> This method must only be invoked while we are synchronized on {@link #cacheLock}.
+   * <b>Note:</b> This method must only be invoked while we are synchronized on [cacheLock].
    * @param source the source that has been changed
    */
   void sourceChanged(Source source) {
     SourceEntry sourceEntry = _sourceMap[source];
     if (sourceEntry is HtmlEntry) {
       HtmlEntryImpl htmlCopy = ((sourceEntry as HtmlEntry)).writableCopy;
       htmlCopy.setState(HtmlEntry.ELEMENT, CacheState.INVALID);
       htmlCopy.setState(SourceEntry.LINE_INFO, CacheState.INVALID);
       htmlCopy.setState(HtmlEntry.PARSED_UNIT, CacheState.INVALID);
       htmlCopy.setState(HtmlEntry.REFERENCED_LIBRARIES, CacheState.INVALID);
       htmlCopy.setState(HtmlEntry.RESOLVED_UNIT, CacheState.INVALID);
       _sourceMap[source] = htmlCopy;
     } else if (sourceEntry is DartEntry) {
-      Set<Source> librariesToInvalidate = new Set<Source>();
       List<Source> containingLibraries = getLibrariesContaining(source);
-      for (Source containingLibrary in containingLibraries) {
-        javaSetAdd(librariesToInvalidate, containingLibrary);
-        for (Source dependentLibrary in getLibrariesDependingOn(containingLibrary)) {
-          javaSetAdd(librariesToInvalidate, dependentLibrary);
-        }
-      }
       DartEntryImpl dartCopy = ((sourceEntry as DartEntry)).writableCopy;
       dartCopy.setState(SourceEntry.LINE_INFO, CacheState.INVALID);
       dartCopy.setState(DartEntry.PARSE_ERRORS, CacheState.INVALID);
       dartCopy.setState(DartEntry.PARSED_UNIT, CacheState.INVALID);
       dartCopy.setState(DartEntry.SOURCE_KIND, CacheState.INVALID);
       _sourceMap[source] = dartCopy;
-      for (Source library in librariesToInvalidate) {
+      for (Source library in containingLibraries) {
         invalidateLibraryResolution(library);
       }
     }
   }
 
   /**
-   * <b>Note:</b> This method must only be invoked while we are synchronized on {@link #cacheLock}.
+   * <b>Note:</b> This method must only be invoked while we are synchronized on [cacheLock].
    * @param source the source that has been deleted
    */
   void sourceRemoved(Source source) {
     DartEntry dartEntry = getDartEntry(source);
     if (dartEntry != null) {
       Set<Source> libraries = new Set<Source>();
       for (Source librarySource in getLibrariesContaining(source)) {
         javaSetAdd(libraries, librarySource);
         for (Source dependentLibrary in getLibrariesDependingOn(librarySource)) {
           javaSetAdd(libraries, dependentLibrary);
         }
       }
       for (Source librarySource in libraries) {
         invalidateLibraryResolution(librarySource);
       }
     }
     _sourceMap.remove(source);
   }
 }
 /**
- * Instances of the class {@code ScanResult} represent the results of scanning a source.
+ * Instances of the class `ScanResult` represent the results of scanning a source.
  */
 class AnalysisContextImpl_ScanResult {
 
   /**
    * The time at which the contents of the source were last set.
    */
   int _modificationTime = 0;
 
   /**
    * The first token in the token stream.
@@ skipping 51 matching lines @@
     result._lineStarts = scanner.lineStarts;
   }
   void accept2(String contents, int modificationTime2) {
     StringScanner scanner = new StringScanner(source, contents, errorListener);
     result._modificationTime = modificationTime2;
     result._token = scanner.tokenize();
     result._lineStarts = scanner.lineStarts;
   }
 }
 /**
- * Instances of the class {@code AnalysisErrorInfoImpl} represent the analysis errors and line info
+ * Instances of the class `AnalysisErrorInfoImpl` represent the analysis errors and line info
  * associated with a source.
  */
 class AnalysisErrorInfoImpl implements AnalysisErrorInfo {
 
   /**
-   * The analysis errors associated with a source, or {@code null} if there are no errors.
+   * The analysis errors associated with a source, or `null` if there are no errors.
    */
   List<AnalysisError> _errors;
 
   /**
-   * The line information associated with the errors, or {@code null} if there are no errors.
+   * The line information associated with the errors, or `null` if there are no errors.
    */
   LineInfo _lineInfo;
 
   /**
    * Initialize an newly created error info with the errors and line information
    * @param errors the errors as a result of analysis
    * @param lineinfo the line info for the errors
    */
   AnalysisErrorInfoImpl(List<AnalysisError> errors, LineInfo lineInfo) {
     this._errors = errors;
     this._lineInfo = lineInfo;
   }
 
   /**
-   * Return the errors of analysis, or {@code null} if there were no errors.
+   * Return the errors of analysis, or `null` if there were no errors.
    * @return the errors as a result of the analysis
    */
   List<AnalysisError> get errors => _errors;
 
   /**
-   * Return the line information associated with the errors, or {@code null} if there were no
+   * Return the line information associated with the errors, or `null` if there were no
    * errors.
    * @return the line information associated with the errors
    */
   LineInfo get lineInfo => _lineInfo;
 }
 /**
- * Instances of the class {@code AnalysisOptions} represent a set of analysis options used to
+ * Instances of the class `AnalysisOptions` represent a set of analysis options used to
  * control the behavior of an analysis context.
  */
 class AnalysisOptionsImpl implements AnalysisOptions {
 
   /**
    * A flag indicating whether analysis is to use strict mode. In strict mode, error reporting is
    * based exclusively on the static type information.
    */
   bool _strictMode = false;
 
   /**
-   * Return {@code true} if analysis is to use strict mode. In strict mode, error reporting is based
+   * Return `true` if analysis is to use strict mode. In strict mode, error reporting is based
    * exclusively on the static type information.
-   * @return {@code true} if analysis is to use strict mode
+   * @return `true` if analysis is to use strict mode
    */
   bool get strictMode => _strictMode;
 
   /**
    * Set whether analysis is to use strict mode to the given value. In strict mode, error reporting
    * is based exclusively on the static type information.
-   * @param isStrict {@code true} if analysis is to use strict mode
+   * @param isStrict `true` if analysis is to use strict mode
    */
   void set strictMode(bool isStrict) {
     _strictMode = isStrict;
   }
 }
 /**
- * The enumeration {@code CacheState} defines the possible states of cached data.
+ * The enumeration `CacheState` defines the possible states of cached data.
  */
 class CacheState implements Comparable<CacheState> {
 
   /**
    * The data is not in the cache and the last time an attempt was made to compute the data an
    * exception occurred, making it pointless to attempt.
-   * <p>
+   *
    * Valid Transitions:
-   * <ul>
-   * <li>{@link #INVALID} if a source was modified that might cause the data to be computable</li>
-   * </ul>
+   *
+   * * [INVALID] if a source was modified that might cause the data to be computable
+   *
    */
   static final CacheState ERROR = new CacheState('ERROR', 0);
 
   /**
    * The data is not in the cache because it was flushed from the cache in order to control memory
    * usage. If the data is recomputed, results do not need to be reported.
-   * <p>
+   *
    * Valid Transitions:
-   * <ul>
-   * <li>{@link #IN_PROCESS} if the data is being recomputed</li>
-   * <li>{@link #INVALID} if a source was modified that causes the data to need to be recomputed</li>
-   * </ul>
+   *
+   * * [IN_PROCESS] if the data is being recomputed
+   * * [INVALID] if a source was modified that causes the data to need to be recomputed
+   *
    */
   static final CacheState FLUSHED = new CacheState('FLUSHED', 1);
 
   /**
    * The data might or might not be in the cache but is in the process of being recomputed.
-   * <p>
+   *
    * Valid Transitions:
-   * <ul>
-   * <li>{@link #ERROR} if an exception occurred while trying to compute the data</li>
-   * <li>{@link #VALID} if the data was successfully computed and stored in the cache</li>
-   * </ul>
+   *
+   * * [ERROR] if an exception occurred while trying to compute the data
+   * * [VALID] if the data was successfully computed and stored in the cache
+   *
    */
   static final CacheState IN_PROCESS = new CacheState('IN_PROCESS', 2);
 
   /**
    * The data is not in the cache and needs to be recomputed so that results can be reported.
-   * <p>
+   *
    * Valid Transitions:
-   * <ul>
-   * <li>{@link #IN_PROCESS} if an attempt is being made to recompute the data</li>
-   * </ul>
+   *
+   * * [IN_PROCESS] if an attempt is being made to recompute the data
+   *
    */
   static final CacheState INVALID = new CacheState('INVALID', 3);
 
   /**
    * The data is in the cache and up-to-date.
-   * <p>
+   *
    * Valid Transitions:
-   * <ul>
-   * <li>{@link #FLUSHED} if the data is removed in order to manage memory usage</li>
-   * <li>{@link #INVALID} if a source was modified in such a way as to invalidate the previous data</li>
-   * </ul>
+   *
+   * * [FLUSHED] if the data is removed in order to manage memory usage
+   * * [INVALID] if a source was modified in such a way as to invalidate the previous data
+   *
    */
   static final CacheState VALID = new CacheState('VALID', 4);
   static final List<CacheState> values = [ERROR, FLUSHED, IN_PROCESS, INVALID, VALID];
 
   /// The name of this enum constant, as declared in the enum declaration.
   final String name;
 
   /// The position in the enum declaration.
   final int ordinal;
   CacheState(this.name, this.ordinal) {
   }
   int compareTo(CacheState other) => ordinal - other.ordinal;
   int get hashCode => ordinal;
   String toString() => name;
 }
 /**
- * Instances of the class {@code ChangeNoticeImpl} represent a change to the analysis results
+ * Instances of the class `ChangeNoticeImpl` represent a change to the analysis results
  * associated with a given source.
  * @coverage dart.engine
  */
 class ChangeNoticeImpl implements ChangeNotice {
 
   /**
    * The source for which the result is being reported.
    */
   Source _source;
 
   /**
-   * The fully resolved AST that changed as a result of the analysis, or {@code null} if the AST was
+   * The fully resolved AST that changed as a result of the analysis, or `null` if the AST was
    * not changed.
    */
   CompilationUnit _compilationUnit;
 
   /**
-   * The errors that changed as a result of the analysis, or {@code null} if errors were not
+   * The errors that changed as a result of the analysis, or `null` if errors were not
    * changed.
    */
   List<AnalysisError> _errors;
 
   /**
-   * The line information associated with the source, or {@code null} if errors were not changed.
+   * The line information associated with the source, or `null` if errors were not changed.
    */
   LineInfo _lineInfo;
 
   /**
    * An empty array of change notices.
    */
   static List<ChangeNoticeImpl> EMPTY_ARRAY = new List<ChangeNoticeImpl>(0);
 
   /**
    * Initialize a newly created notice associated with the given source.
    * @param source the source for which the change is being reported
    */
   ChangeNoticeImpl(Source source) {
     this._source = source;
   }
 
   /**
-   * Return the fully resolved AST that changed as a result of the analysis, or {@code null} if the
+   * Return the fully resolved AST that changed as a result of the analysis, or `null` if the
    * AST was not changed.
    * @return the fully resolved AST that changed as a result of the analysis
    */
   CompilationUnit get compilationUnit => _compilationUnit;
 
   /**
-   * Return the errors that changed as a result of the analysis, or {@code null} if errors were not
+   * Return the errors that changed as a result of the analysis, or `null` if errors were not
    * changed.
    * @return the errors that changed as a result of the analysis
    */
   List<AnalysisError> get errors => _errors;
 
   /**
-   * Return the line information associated with the source, or {@code null} if errors were not
+   * Return the line information associated with the source, or `null` if errors were not
    * changed.
    * @return the line information associated with the source
    */
   LineInfo get lineInfo => _lineInfo;
 
   /**
    * Return the source for which the result is being reported.
    * @return the source for which the result is being reported
    */
   Source get source => _source;
@@ skipping 11 matching lines @@
    * information to the given line information.
    * @param errors the errors that changed as a result of the analysis
    * @param lineInfo the line information associated with the source
    */
   void setErrors(List<AnalysisError> errors2, LineInfo lineInfo2) {
     this._errors = errors2;
     this._lineInfo = lineInfo2;
   }
 }
 /**
- * Instances of the class {@code DelegatingAnalysisContextImpl} extend {@link AnalysisContextImplanalysis context} to delegate sources to the appropriate analysis context. For instance, if the
- * source is in a system library then the analysis context from the {@link DartSdk} is used.
+ * Instances of the class `DelegatingAnalysisContextImpl` extend [AnalysisContextImplanalysis context] to delegate sources to the appropriate analysis context. For instance, if the
+ * source is in a system library then the analysis context from the [DartSdk] is used.
  * @coverage dart.engine
  */
 class DelegatingAnalysisContextImpl extends AnalysisContextImpl {
 
   /**
-   * This references the {@link InternalAnalysisContext} held onto by the {@link DartSdk} which is
-   * used (instead of this {@link AnalysisContext}) for SDK sources. This field is set when
-   * #setSourceFactory(SourceFactory) is called, and references the analysis context in the{@link DartUriResolver} in the {@link SourceFactory}, this analysis context assumes that there
+   * This references the [InternalAnalysisContext] held onto by the [DartSdk] which is
+   * used (instead of this [AnalysisContext]) for SDK sources. This field is set when
+   * #setSourceFactory(SourceFactory) is called, and references the analysis context in the[DartUriResolver] in the [SourceFactory], this analysis context assumes that there
    * will be such a resolver.
    */
   InternalAnalysisContext _sdkAnalysisContext;
   void addSourceInfo(Source source, SourceEntry info) {
     if (source.isInSystemLibrary()) {
       _sdkAnalysisContext.addSourceInfo(source, info);
     } else {
       super.addSourceInfo(source, info);
     }
   }
@@ skipping 200 matching lines @@
       if (_sdkAnalysisContext is DelegatingAnalysisContextImpl) {
         _sdkAnalysisContext = null;
         throw new IllegalStateException("The context provided by an SDK cannot itself be a delegating analysis context");
       }
     } else {
       throw new IllegalStateException("SourceFactorys provided to DelegatingAnalysisContextImpls must have a DartSdk associated with the provided SourceFactory.");
     }
   }
 }
 /**
- * Instances of the class {@code InstrumentedAnalysisContextImpl} implement an{@link AnalysisContext analysis context} by recording instrumentation data and delegating to
+ * Instances of the class `InstrumentedAnalysisContextImpl` implement an[AnalysisContext analysis context] by recording instrumentation data and delegating to
  * another analysis context to do the non-instrumentation work.
  * @coverage dart.engine
  */
 class InstrumentedAnalysisContextImpl implements InternalAnalysisContext {
 
   /**
    * Record an exception that was thrown during analysis.
    * @param instrumentation the instrumentation builder being used to record the exception
    * @param exception the exception being reported
    */
   static void recordAnalysisException(InstrumentationBuilder instrumentation, AnalysisException exception) {
     instrumentation.record(exception);
   }
 
   /**
    * The unique identifier used to identify this analysis context in the instrumentation data.
    */
   String _contextId = UUID.randomUUID().toString();
 
   /**
    * The analysis context to which all of the non-instrumentation work is delegated.
    */
   InternalAnalysisContext _basis;
 
   /**
-   * Create a new {@link InstrumentedAnalysisContextImpl} which wraps a new{@link AnalysisContextImpl} as the basis context.
+   * Create a new [InstrumentedAnalysisContextImpl] which wraps a new[AnalysisContextImpl] as the basis context.
    */
   InstrumentedAnalysisContextImpl() {
     _jtd_constructor_183_impl();
   }
   _jtd_constructor_183_impl() {
     _jtd_constructor_184_impl(new AnalysisContextImpl());
   }
 
   /**
-   * Create a new {@link InstrumentedAnalysisContextImpl} with a specified basis context, aka the
+   * Create a new [InstrumentedAnalysisContextImpl] with a specified basis context, aka the
    * context to wrap and instrument.
-   * @param context some {@link InstrumentedAnalysisContext} to wrap and instrument
+   * @param context some [InstrumentedAnalysisContext] to wrap and instrument
    */
   InstrumentedAnalysisContextImpl.con1(InternalAnalysisContext context) {
     _jtd_constructor_184_impl(context);
   }
   _jtd_constructor_184_impl(InternalAnalysisContext context) {
     _basis = context;
   }
   void addSourceInfo(Source source, SourceEntry info) {
     _basis.addSourceInfo(source, info);
   }
@@ skipping 88 matching lines @@
     InstrumentationBuilder instrumentation = Instrumentation.builder2("Analysis-getAnalysisOptions");
     try {
       instrumentation.metric3("contextId", _contextId);
       return _basis.analysisOptions;
     } finally {
       instrumentation.log();
     }
   }
 
   /**
-   * @return the underlying {@link AnalysisContext}.
+   * @return the underlying [AnalysisContext].
    */
   AnalysisContext get basis => _basis;
   Element getElement(ElementLocation location) {
     InstrumentationBuilder instrumentation = Instrumentation.builder2("Analysis-getElement");
     try {
       instrumentation.metric3("contextId", _contextId);
       return _basis.getElement(location);
     } finally {
       instrumentation.log();
     }
@@ skipping 304 matching lines @@
     InstrumentationBuilder instrumentation = Instrumentation.builder2("Analysis-sourcesToResolve");
     try {
       instrumentation.metric3("contextId", _contextId);
       return _basis.sourcesToResolve(changedSources);
     } finally {
       instrumentation.log();
     }
   }
 }
 /**
- * The interface {@code InternalAnalysisContext} defines additional behavior for an analysis context
+ * The interface `InternalAnalysisContext` defines additional behavior for an analysis context
  * that is required by internal users of the context.
  */
 abstract class InternalAnalysisContext implements AnalysisContext {
 
   /**
    * Add the given source with the given information to this context.
    * @param source the source to be added
    * @param info the information about the source
    */
   void addSourceInfo(Source source, SourceEntry info);
@@ skipping 37 matching lines @@
 
   /**
    * Given a table mapping the source for the libraries represented by the corresponding elements to
    * the elements representing the libraries, record those mappings.
    * @param elementMap a table mapping the source for the libraries represented by the elements to
    * the elements representing the libraries
    */
   void recordLibraryElements(Map<Source, LibraryElement> elementMap);
 }
 /**
- * Instances of the class {@code RecordingErrorListener} implement an error listener that will
+ * Instances of the class `RecordingErrorListener` implement an error listener that will
  * record the errors that are reported to it in a way that is appropriate for caching those errors
  * within an analysis context.
  * @coverage dart.engine
  */
 class RecordingErrorListener implements AnalysisErrorListener {
 
   /**
-   * A HashMap of lists containing the errors that were collected, keyed by each {@link Source}.
+   * A HashMap of lists containing the errors that were collected, keyed by each [Source].
    */
   Map<Source, List<AnalysisError>> _errors = new Map<Source, List<AnalysisError>>();
 
   /**
    * Add all of the errors recorded by the given listener to this listener.
    * @param listener the listener that has recorded the errors to be added
    */
   void addAll(RecordingErrorListener listener) {
     for (AnalysisError error in listener.errors) {
       onError(error);
     }
   }
 
   /**
    * Answer the errors collected by the listener.
-   * @return an array of errors (not {@code null}, contains no {@code null}s)
+   * @return an array of errors (not `null`, contains no `null`s)
    */
   List<AnalysisError> get errors {
     Iterable<MapEntry<Source, List<AnalysisError>>> entrySet = getMapEntrySet(_errors);
     int numEntries = entrySet.length;
     if (numEntries == 0) {
       return AnalysisError.NO_ERRORS;
     }
     List<AnalysisError> resultList = new List<AnalysisError>();
     for (MapEntry<Source, List<AnalysisError>> entry in entrySet) {
       resultList.addAll(entry.getValue());
     }
     return new List.from(resultList);
   }
 
   /**
-   * Answer the errors collected by the listener for some passed {@link Source}.
-   * @param source some {@link Source} for which the caller wants the set of {@link AnalysisError}s
+   * Answer the errors collected by the listener for some passed [Source].
+   * @param source some [Source] for which the caller wants the set of [AnalysisError]s
    * collected by this listener
-   * @return the errors collected by the listener for the passed {@link Source}
+   * @return the errors collected by the listener for the passed [Source]
    */
   List<AnalysisError> getErrors2(Source source) {
     List<AnalysisError> errorsForSource = _errors[source];
     if (errorsForSource == null) {
       return AnalysisError.NO_ERRORS;
     } else {
       return new List.from(errorsForSource);
     }
   }
   void onError(AnalysisError event) {
     Source source = event.source;
     List<AnalysisError> errorsForSource = _errors[source];
     if (_errors[source] == null) {
       errorsForSource = new List<AnalysisError>();
       _errors[source] = errorsForSource;
     }
     errorsForSource.add(event);
   }
 }
 /**
- * Instances of the class {@code ResolutionEraser} remove any resolution information from an AST
+ * Instances of the class `ResolutionEraser` remove any resolution information from an AST
  * structure when used to visit that structure.
  */
 class ResolutionEraser extends GeneralizingASTVisitor<Object> {
   Object visitAssignmentExpression(AssignmentExpression node) {
     node.element = null;
     return super.visitAssignmentExpression(node);
   }
   Object visitBinaryExpression(BinaryExpression node) {
     node.element = null;
     return super.visitBinaryExpression(node);
@@ skipping 50 matching lines @@
   Object visitSimpleIdentifier(SimpleIdentifier node) {
     node.element = null;
     return super.visitSimpleIdentifier(node);
   }
   Object visitSuperConstructorInvocation(SuperConstructorInvocation node) {
     node.element = null;
     return super.visitSuperConstructorInvocation(node);
   }
 }
 /**
- * The interface {@code Logger} defines the behavior of objects that can be used to receive
+ * The interface `Logger` defines the behavior of objects that can be used to receive
  * information about errors within the analysis engine. Implementations usually write this
  * information to a file, but can also record the information for later use (such as during testing)
  * or even ignore the information.
  * @coverage dart.engine.utilities
  */
 abstract class Logger {
   static final Logger NULL = new Logger_NullLogger();
 
   /**
    * Log the given message as an error.
@@ skipping 22 matching lines @@
   void logInformation(String message);
 
   /**
    * Log the given exception as one representing an informational message.
    * @param message an explanation of why the error occurred or what it means
    * @param exception the exception being logged
    */
   void logInformation2(String message, Exception exception);
 }
 /**
- * Implementation of {@link Logger} that does nothing.
+ * Implementation of [Logger] that does nothing.
  */
 class Logger_NullLogger implements Logger {
   void logError(String message) {
   }
   void logError2(String message, Exception exception) {
   }
   void logError3(Exception exception) {
   }
   void logInformation(String message) {
   }
   void logInformation2(String message, Exception exception) {
   }
 }