Clean up comments in error support

pkg/analyzer/lib/src/generated/error.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 engine.error;
 
 import 'dart:collection';
 
 import 'ast.dart' show AstNode;
 import 'element.dart';
 import 'java_core.dart';
 import 'scanner.dart' show Token;
 import 'source.dart';
 
 /**
- * Instances of the class `AnalysisError` represent an error discovered during the analysis of
- * some Dart code.
+ * An error discovered during the analysis of some Dart code.
  *
  * See [AnalysisErrorListener].
  */
 class AnalysisError {
   /**
    * An empty array of errors used when no errors are expected.
    */
   static const List<AnalysisError> NO_ERRORS = const <AnalysisError>[];
 
   /**
-   * A [Comparator] that sorts by the name of the file that the [AnalysisError] was
-   * found.
+   * A [Comparator] that sorts by the name of the file that the [AnalysisError]
+   * was found.
    */
   static Comparator<AnalysisError> FILE_COMPARATOR = (AnalysisError o1,
       AnalysisError o2) => o1.source.shortName.compareTo(o2.source.shortName);
 
   /**
-   * A [Comparator] that sorts error codes first by their severity (errors first, warnings
-   * second), and then by the the error code type.
+   * A [Comparator] that sorts error codes first by their severity (errors
+   * first, warnings second), and then by the the error code type.
    */
   static Comparator<AnalysisError> ERROR_CODE_COMPARATOR = (AnalysisError o1,
       AnalysisError o2) {
     ErrorCode errorCode1 = o1.errorCode;
     ErrorCode errorCode2 = o2.errorCode;
     ErrorSeverity errorSeverity1 = errorCode1.errorSeverity;
     ErrorSeverity errorSeverity2 = errorCode2.errorSeverity;
     ErrorType errorType1 = errorCode1.type;
     ErrorType errorType2 = errorCode2.type;
     if (errorSeverity1 == errorSeverity2) {
       return errorType1.compareTo(errorType2);
     } else {
       return errorSeverity2.compareTo(errorSeverity1);
     }
   };
 
   /**
    * The error code associated with the error.
    */
   final ErrorCode errorCode;
 
   /**
    * The localized error message.
    */
   String _message;
 
   /**
-   * The correction to be displayed for this error, or `null` if there is no correction
-   * information for this error.
+   * The correction to be displayed for this error, or `null` if there is no
+   * correction information for this error.
    */
   String _correction;
 
   /**
    * The source in which the error occurred, or `null` if unknown.
    */
   Source source;
 
   /**
    * The character offset from the beginning of the source (zero based) where
    * the error occurred.
    */
   int offset = 0;
 
   /**
-   * The number of characters from the offset to the end of the source which encompasses the
-   * compilation error.
+   * The number of characters from the offset to the end of the source which
+   * encompasses the compilation error.
    */
   int _length = 0;
 
   /**
-   * A flag indicating whether this error can be shown to be a non-issue because of the result of
-   * type propagation.
+   * A flag indicating whether this error can be shown to be a non-issue because
+   * of the result of type propagation.
    */
   bool isStaticOnly = false;
 
   /**
-   * Initialize a newly created analysis error for the specified source. The error has no location
-   * information.
-   *
-   * @param source the source for which the exception occurred
-   * @param errorCode the error code to be associated with this error
-   * @param arguments the arguments used to build the error message
+   * Initialize a newly created analysis error for the specified [source]. The
+   * error will have the given [errorCode] and the list of [arguments] will be
+   * used to complete the message. The error has no location information.
    */
   AnalysisError.con1(this.source, this.errorCode, [List<Object> arguments]) {
     this._message = formatList(errorCode.message, arguments);
   }
 
   /**
-   * Initialize a newly created analysis error for the specified source at the given location.
-   *
-   * @param source the source for which the exception occurred
-   * @param offset the offset of the location of the error
-   * @param length the length of the location of the error
-   * @param errorCode the error code to be associated with this error
-   * @param arguments the arguments used to build the error message
+   * Initialize a newly created analysis error for the specified [source] at the
+   * given [offset] with the given [length]. The error will have the given
+   * [errorCode] and the list of [arguments] will be used to complete the
+   * message.
    */
   AnalysisError.con2(this.source, this.offset, int length, this.errorCode,
       [List<Object> arguments]) {
     this._length = length;
     this._message = formatList(errorCode.message, arguments);
     String correctionTemplate = errorCode.correction;
     if (correctionTemplate != null) {
       this._correction = formatList(correctionTemplate, arguments);
     }
   }
 
   /**
-   * Return the correction to be displayed for this error, or `null` if there is no correction
-   * information for this error. The correction should indicate how the user can fix the error.
-   *
-   * @return the template used to create the correction to be displayed for this error
+   * Return the template used to create the correction to be displayed for this
+   * error, or `null` if there is no correction information for this error. The
+   * correction should indicate how the user can fix the error.
    */
   String get correction => _correction;
 
   @override
   int get hashCode {
     int hashCode = offset;
     hashCode ^= (_message != null) ? _message.hashCode : 0;
     hashCode ^= (source != null) ? source.hashCode : 0;
     return hashCode;
   }
 
   /**
-   * Return the number of characters from the offset to the end of the source which encompasses the
-   * compilation error.
-   *
-   * @return the length of the error location
+   * Return the length of the error location, that is, the number of characters
+   * from the offset to the end of the source which encompasses the compilation
+   * error.
    */
   int get length => _length;
 
   /**
-   * Return the message to be displayed for this error. The message should indicate what is wrong
-   * and why it is wrong.
-   *
-   * @return the message to be displayed for this error
+   * Return the message to be displayed for this error. The message should
+   * indicate what is wrong and why it is wrong.
    */
   String get message => _message;
 
   @override
   bool operator ==(Object obj) {
     if (identical(obj, this)) {
       return true;
     }
     // prepare other AnalysisError
     if (obj is! AnalysisError) {
@@ skipping 15 matching lines @@
       return false;
     }
     if (source != other.source) {
       return false;
     }
     // OK
     return true;
   }
 
   /**
-   * Return the value of the given property, or `null` if the given property is not defined
-   * for this error.
-   *
-   * @param property the property whose value is to be returned
-   * @return the value of the given property
+   * Return the value of the given [property], or `null` if the given property
+   * is not defined for this error.
    */
   Object getProperty(ErrorProperty property) => null;
 
   @override
   String toString() {
     StringBuffer buffer = new StringBuffer();
     buffer.write((source != null) ? source.fullName : "<unknown source>");
     buffer.write("(");
     buffer.write(offset);
     buffer.write("..");
     buffer.write(offset + _length - 1);
     buffer.write("): ");
     //buffer.write("(" + lineNumber + ":" + columnNumber + "): ");
     buffer.write(_message);
     return buffer.toString();
   }
 }
 
 /**
- * The interface `AnalysisErrorListener` defines the behavior of objects that listen for
- * [AnalysisError] being produced by the analysis engine.
+ * An object that listen for [AnalysisError]s being produced by the analysis
+ * engine.
  */
 abstract class AnalysisErrorListener {
   /**
    * An error listener that ignores errors that are reported to it.
    */
   static final AnalysisErrorListener NULL_LISTENER =
       new AnalysisErrorListener_NULL_LISTENER();
 
   /**
-   * This method is invoked when an error has been found by the analysis engine.
-   *
-   * @param error the error that was just found (not `null`)
+   * This method is invoked when an [error] has been found by the analysis
+   * engine.
    */
   void onError(AnalysisError error);
 }
 
+/**
+ * An [AnalysisErrorListener] that ignores error.
+ */
 class AnalysisErrorListener_NULL_LISTENER implements AnalysisErrorListener {
   @override
   void onError(AnalysisError event) {
     // Ignore errors
   }
 }
 
 /**
- * Instances of the class `AnalysisErrorWithProperties`
+ * An [AnalysisError] that can have arbitrary properties associated with it.
  */
 class AnalysisErrorWithProperties extends AnalysisError {
   /**
    * The properties associated with this error.
    */
   HashMap<ErrorProperty, Object> _propertyMap =
       new HashMap<ErrorProperty, Object>();
 
   /**
-   * Initialize a newly created analysis error for the specified source. The error has no location
-   * information.
-   *
-   * @param source the source for which the exception occurred
-   * @param errorCode the error code to be associated with this error
-   * @param arguments the arguments used to build the error message
+   * Initialize a newly created analysis error for the specified [source]. The
+   * error will have the given [errorCode] and the list of [arguments] will be
+   * used to complete the message. The error has no location information.
    */
   AnalysisErrorWithProperties.con1(
       Source source, ErrorCode errorCode, List<Object> arguments)
       : super.con1(source, errorCode, arguments);
 
   /**
-   * Initialize a newly created analysis error for the specified source at the given location.
-   *
-   * @param source the source for which the exception occurred
-   * @param offset the offset of the location of the error
-   * @param length the length of the location of the error
-   * @param errorCode the error code to be associated with this error
-   * @param arguments the arguments used to build the error message
+   * Initialize a newly created analysis error for the specified [source] at the
+   * given [offset] with the given [length]. The error will have the given
+   * [errorCode] and the list of [arguments] will be used to complete the
+   * message.
    */
   AnalysisErrorWithProperties.con2(Source source, int offset, int length,
       ErrorCode errorCode, List<Object> arguments)
       : super.con2(source, offset, length, errorCode, arguments);
 
   @override
   Object getProperty(ErrorProperty property) => _propertyMap[property];
 
   /**
-   * Set the value of the given property to the given value. Using a value of `null` will
-   * effectively remove the property from this error.
-   *
-   * @param property the property whose value is to be returned
-   * @param value the new value of the given property
+   * Set the value of the given [property] to the given [value]. Using a value
+   * of `null` will effectively remove the property from this error.
    */
   void setProperty(ErrorProperty property, Object value) {
     _propertyMap[property] = value;
   }
 }
 
 /**
- * Instances of the class `BooleanErrorListener` implement a listener that keeps track of
- * whether an error has been reported to it.
+ * An [AnalysisErrorListener] that keeps track of whether any error has been
+ * reported to it.
  */
 class BooleanErrorListener implements AnalysisErrorListener {
   /**
    * A flag indicating whether an error has been reported to this listener.
    */
   bool _errorReported = false;
 
   /**
    * Return `true` if an error has been reported to this listener.
-   *
-   * @return `true` if an error has been reported to this listener
    */
   bool get errorReported => _errorReported;
 
   @override
   void onError(AnalysisError error) {
     _errorReported = true;
   }
 }
 
 /**
- * The enumeration `CompileTimeErrorCode` defines the error codes used for
- * compile time errors caused by constant evaluation that would throw an
- * exception when run in checked mode. The client of the analysis engine is
- * responsible for determining how these errors should be presented to the user
- * (for example, a command-line compiler might elect to treat these errors
- * differently depending whether it is compiling it "checked" mode).
+ * The error codes used for compile time errors caused by constant evaluation
+ * that would throw an exception when run in checked mode. The client of the
+ * analysis engine is responsible for determining how these errors should be
+ * presented to the user (for example, a command-line compiler might elect to
+ * treat these errors differently depending whether it is compiling it "checked"
+ * mode).
  */
 class CheckedModeCompileTimeErrorCode extends ErrorCode {
   // TODO(paulberry): improve the text of these error messages so that it's
   // clear to the user that the error is coming from constant evaluation (and
   // hence the constant needs to be a subtype of the annotated type) as opposed
   // to static type analysis (which only requires that the two types be
   // assignable).  Also consider populating the "correction" field for these
   // errors.
 
   /**
@@ skipping 15 matching lines @@
           "The object type '{0}' cannot be assigned to a parameter of type '{1}'");
 
   /**
    * 7.6.1 Generative Constructors: In checked mode, it is a dynamic type error
    * if o is not <b>null</b> and the interface of the class of <i>o</i> is not a
    * subtype of the static type of the field <i>v</i>.
    *
    * 12.11.2 Const: It is a compile-time error if evaluation of a constant
    * object results in an uncaught exception being thrown.
    *
-   * @param initializerType the name of the type of the initializer expression
-   * @param fieldType the name of the type of the field
+   * Parameters:
+   * 0: the name of the type of the initializer expression
+   * 1: the name of the type of the field
    */
   static const CheckedModeCompileTimeErrorCode CONST_FIELD_INITIALIZER_NOT_ASSIGNABLE =
       const CheckedModeCompileTimeErrorCode(
           'CONST_FIELD_INITIALIZER_NOT_ASSIGNABLE',
           "The initializer type '{0}' cannot be assigned to the field type '{1}'");
 
   /**
    * 12.6 Lists: A run-time list literal &lt;<i>E</i>&gt; [<i>e<sub>1</sub></i>
    * ... <i>e<sub>n</sub></i>] is evaluated as follows:
    * * The operator []= is invoked on <i>a</i> with first argument <i>i</i> and
@@ skipping 68 matching lines @@
 
   @override
   ErrorSeverity get errorSeverity =>
       ErrorType.CHECKED_MODE_COMPILE_TIME_ERROR.severity;
 
   @override
   ErrorType get type => ErrorType.CHECKED_MODE_COMPILE_TIME_ERROR;
 }
 
 /**
- * The enumeration `CompileTimeErrorCode` defines the error codes used for
- * compile time errors. The convention for this class is for the name of the
- * error code to indicate the problem that caused the error to be generated and
- * for the error message to explain what is wrong and, when appropriate, how the
- * problem can be corrected.
+ * The error codes used for compile time errors. The convention for this class
+ * is for the name of the error code to indicate the problem that caused the
+ * error to be generated and for the error message to explain what is wrong and,
+ * when appropriate, how the problem can be corrected.
  */
 class CompileTimeErrorCode extends ErrorCode {
   /**
    * Enum proposal: It is also a compile-time error to explicitly instantiate an
    * enum via 'new' or 'const' or to access its private fields.
    */
   static const CompileTimeErrorCode ACCESS_PRIVATE_ENUM_FIELD =
       const CompileTimeErrorCode('ACCESS_PRIVATE_ENUM_FIELD',
           "The private fields of an enum cannot be accessed, even within the same library");
 
   /**
    * 14.2 Exports: It is a compile-time error if a name <i>N</i> is re-exported
    * by a library <i>L</i> and <i>N</i> is introduced into the export namespace
    * of <i>L</i> by more than one export, unless each all exports refer to same
    * declaration for the name N.
    *
-   * @param ambiguousElementName the name of the ambiguous element
-   * @param firstLibraryName the name of the first library that the type is
-   *        found
-   * @param secondLibraryName the name of the second library that the type is
-   *        found
+   * Parameters:
+   * 0: the name of the ambiguous element
+   * 1: the name of the first library that the type is found
+   * 2: the name of the second library that the type is found
    */
   static const CompileTimeErrorCode AMBIGUOUS_EXPORT =
       const CompileTimeErrorCode('AMBIGUOUS_EXPORT',
           "The name '{0}' is defined in the libraries '{1}' and '{2}'");
 
   /**
    * 12.33 Argument Definition Test: It is a compile time error if <i>v</i> does
    * not denote a formal parameter.
    *
-   * @param the name of the identifier in the argument definition test that is
-   *        not a parameter
+   * Parameters:
+   * 0: the name of the identifier in the argument definition test that is not a
+   *    parameter
    */
   static const CompileTimeErrorCode ARGUMENT_DEFINITION_TEST_NON_PARAMETER =
       const CompileTimeErrorCode(
           'ARGUMENT_DEFINITION_TEST_NON_PARAMETER', "'{0}' is not a parameter");
 
   /**
    * ?? Asynchronous For-in: It is a compile-time error if an asynchronous
    * for-in statement appears inside a synchronous function.
    */
   static const CompileTimeErrorCode ASYNC_FOR_IN_WRONG_CONTEXT =
@@ skipping 218 matching lines @@
    */
   static const CompileTimeErrorCode CONST_MAP_KEY_EXPRESSION_TYPE_IMPLEMENTS_EQUALS =
       const CompileTimeErrorCode(
           'CONST_MAP_KEY_EXPRESSION_TYPE_IMPLEMENTS_EQUALS',
           "The constant map entry key expression type '{0}' cannot override the == operator");
 
   /**
    * 5 Variables: A constant variable must be initialized to a compile-time
    * constant (12.1) or a compile-time error occurs.
    *
-   * @param name the name of the uninitialized final variable
+   * Parameters:
+   * 0: the name of the uninitialized final variable
    */
   static const CompileTimeErrorCode CONST_NOT_INITIALIZED =
       const CompileTimeErrorCode('CONST_NOT_INITIALIZED',
           "The const variable '{0}' must be initialized");
 
   /**
    * 12.11.2 Const: An expression of one of the forms !e, e1 && e2 or e1 || e2,
    * where e, e1 and e2 are constant expressions that evaluate to a boolean
    * value.
    */
@@ skipping 43 matching lines @@
    */
   static const CompileTimeErrorCode CONST_EVAL_THROWS_IDBZE =
       const CompileTimeErrorCode('CONST_EVAL_THROWS_IDBZE',
           "Evaluation of this constant expression throws IntegerDivisionByZeroException");
 
   /**
    * 12.11.2 Const: If <i>T</i> is a parameterized type <i>S&lt;U<sub>1</sub>,
    * &hellip;, U<sub>m</sub>&gt;</i>, let <i>R = S</i>; It is a compile time
    * error if <i>S</i> is not a generic type with <i>m</i> type parameters.
    *
-   * @param typeName the name of the type being referenced (<i>S</i>)
-   * @param parameterCount the number of type parameters that were declared
-   * @param argumentCount the number of type arguments provided
+   * Parameters:
+   * 0: the name of the type being referenced (<i>S</i>)
+   * 1: the number of type parameters that were declared
+   * 2: the number of type arguments provided
+   *
    * See [CompileTimeErrorCode.NEW_WITH_INVALID_TYPE_PARAMETERS], and
    * [StaticTypeWarningCode.WRONG_NUMBER_OF_TYPE_ARGUMENTS].
    */
   static const CompileTimeErrorCode CONST_WITH_INVALID_TYPE_PARAMETERS =
       const CompileTimeErrorCode('CONST_WITH_INVALID_TYPE_PARAMETERS',
           "The type '{0}' is declared with {1} type parameters, but {2} type arguments were given");
 
   /**
    * 12.11.2 Const: If <i>e</i> is of the form <i>const T(a<sub>1</sub>,
    * &hellip;, a<sub>n</sub>, x<sub>n+1</sub>: a<sub>n+1</sub>, &hellip;,
@@ skipping 17 matching lines @@
   /**
    * 12.11.2 Const: It is a compile-time error if <i>T</i> is not a class
    * accessible in the current scope, optionally followed by type arguments.
    *
    * 12.11.2 Const: If <i>e</i> is of the form <i>const T.id(a<sub>1</sub>,
    * &hellip;, a<sub>n</sub>, x<sub>n+1</sub>: a<sub>n+1</sub>, &hellip;
    * x<sub>n+k</sub>: a<sub>n+k</sub>)</i> it is a compile-time error if
    * <i>T</i> is not a class accessible in the current scope, optionally
    * followed by type arguments.
    *
-   * @param name the name of the non-type element
+   * Parameters:
+   * 0: the name of the non-type element
    */
   static const CompileTimeErrorCode CONST_WITH_NON_TYPE =
       const CompileTimeErrorCode(
           'CONST_WITH_NON_TYPE', "The name '{0}' is not a class");
 
   /**
    * 12.11.2 Const: It is a compile-time error if <i>T</i> includes any type
    * parameters.
    */
   static const CompileTimeErrorCode CONST_WITH_TYPE_PARAMETERS =
       const CompileTimeErrorCode('CONST_WITH_TYPE_PARAMETERS',
           "The constant creation cannot use a type parameter");
 
   /**
    * 12.11.2 Const: It is a compile-time error if <i>T.id</i> is not the name of
    * a constant constructor declared by the type <i>T</i>.
    *
-   * @param typeName the name of the type
-   * @param constructorName the name of the requested constant constructor
+   * Parameters:
+   * 0: the name of the type
+   * 1: the name of the requested constant constructor
    */
   static const CompileTimeErrorCode CONST_WITH_UNDEFINED_CONSTRUCTOR =
       const CompileTimeErrorCode('CONST_WITH_UNDEFINED_CONSTRUCTOR',
           "The class '{0}' does not have a constant constructor '{1}'");
 
   /**
    * 12.11.2 Const: It is a compile-time error if <i>T.id</i> is not the name of
    * a constant constructor declared by the type <i>T</i>.
    *
-   * @param typeName the name of the type
+   * Parameters:
+   * 0: the name of the type
    */
   static const CompileTimeErrorCode CONST_WITH_UNDEFINED_CONSTRUCTOR_DEFAULT =
       const CompileTimeErrorCode('CONST_WITH_UNDEFINED_CONSTRUCTOR_DEFAULT',
           "The class '{0}' does not have a default constant constructor");
 
   /**
    * 15.3.1 Typedef: It is a compile-time error if any default values are
    * specified in the signature of a function type alias.
    */
   static const CompileTimeErrorCode DEFAULT_VALUE_IN_FUNCTION_TYPE_ALIAS =
@@ skipping 24 matching lines @@
    * with the same name declared in the same scope.
    */
   static const CompileTimeErrorCode DUPLICATE_CONSTRUCTOR_DEFAULT =
       const CompileTimeErrorCode('DUPLICATE_CONSTRUCTOR_DEFAULT',
           "The default constructor is already defined");
 
   /**
    * 3.1 Scoping: It is a compile-time error if there is more than one entity
    * with the same name declared in the same scope.
    *
-   * @param duplicateName the name of the duplicate entity
+   * Parameters:
+   * 0: the name of the duplicate entity
    */
   static const CompileTimeErrorCode DUPLICATE_CONSTRUCTOR_NAME =
       const CompileTimeErrorCode('DUPLICATE_CONSTRUCTOR_NAME',
           "The constructor with name '{0}' is already defined");
 
   /**
    * 3.1 Scoping: It is a compile-time error if there is more than one entity
    * with the same name declared in the same scope.
    *
    * 7 Classes: It is a compile-time error if a class declares two members of
    * the same name.
    *
    * 7 Classes: It is a compile-time error if a class has an instance member and
    * a static member with the same name.
    *
-   * @param duplicateName the name of the duplicate entity
+   * Parameters:
+   * 0: the name of the duplicate entity
    */
   static const CompileTimeErrorCode DUPLICATE_DEFINITION =
       const CompileTimeErrorCode(
           'DUPLICATE_DEFINITION', "The name '{0}' is already defined");
 
   /**
    * 7. Classes: It is a compile-time error if a class has an instance member
    * and a static member with the same name.
    *
    * This covers the additional duplicate definition cases where inheritance has
    * to be considered.
    *
-   * @param className the name of the class that has conflicting instance/static
-   *        members
-   * @param name the name of the conflicting members
+   * Parameters:
+   * 0: the name of the class that has conflicting instance/static members
+   * 1: the name of the conflicting members
+   *
    * See [DUPLICATE_DEFINITION].
    */
   static const CompileTimeErrorCode DUPLICATE_DEFINITION_INHERITANCE =
       const CompileTimeErrorCode('DUPLICATE_DEFINITION_INHERITANCE',
           "The name '{0}' is already defined in '{1}'");
 
   /**
    * 12.14.2 Binding Actuals to Formals: It is a compile-time error if
    * <i>q<sub>i</sub> = q<sub>j</sub></i> for any <i>i != j</i> [where
    * <i>q<sub>i</sub></i> is the label for a named argument].
    */
   static const CompileTimeErrorCode DUPLICATE_NAMED_ARGUMENT =
       const CompileTimeErrorCode('DUPLICATE_NAMED_ARGUMENT',
           "The argument for the named parameter '{0}' was already specified");
 
   /**
    * SDK implementation libraries can be exported only by other SDK libraries.
    *
-   * @param uri the uri pointing to a library
+   * Parameters:
+   * 0: the uri pointing to a library
    */
   static const CompileTimeErrorCode EXPORT_INTERNAL_LIBRARY =
       const CompileTimeErrorCode('EXPORT_INTERNAL_LIBRARY',
           "The library '{0}' is internal and cannot be exported");
 
   /**
    * 14.2 Exports: It is a compile-time error if the compilation unit found at
    * the specified URI is not a library declaration.
    *
-   * @param uri the uri pointing to a non-library declaration
+   * Parameters:
+   * 0: the uri pointing to a non-library declaration
    */
   static const CompileTimeErrorCode EXPORT_OF_NON_LIBRARY =
       const CompileTimeErrorCode('EXPORT_OF_NON_LIBRARY',
           "The exported library '{0}' must not have a part-of directive");
 
   /**
    * Enum proposal: It is a compile-time error to subclass, mix-in or implement
    * an enum.
    */
   static const CompileTimeErrorCode EXTENDS_ENUM = const CompileTimeErrorCode(
       'EXTENDS_ENUM', "Classes cannot extend an enum");
 
   /**
    * 7.9 Superclasses: It is a compile-time error if the extends clause of a
    * class <i>C</i> includes a type expression that does not denote a class
    * available in the lexical scope of <i>C</i>.
    *
-   * @param typeName the name of the superclass that was not found
+   * Parameters:
+   * 0: the name of the superclass that was not found
    */
   static const CompileTimeErrorCode EXTENDS_NON_CLASS =
       const CompileTimeErrorCode(
           'EXTENDS_NON_CLASS', "Classes can only extend other classes");
 
   /**
    * 12.2 Null: It is a compile-time error for a class to attempt to extend or
    * implement Null.
    *
    * 12.3 Numbers: It is a compile-time error for a class to attempt to extend
    * or implement int.
    *
    * 12.3 Numbers: It is a compile-time error for a class to attempt to extend
    * or implement double.
    *
    * 12.3 Numbers: It is a compile-time error for any type other than the types
    * int and double to
    * attempt to extend or implement num.
    *
    * 12.4 Booleans: It is a compile-time error for a class to attempt to extend
    * or implement bool.
    *
    * 12.5 Strings: It is a compile-time error for a class to attempt to extend
    * or implement String.
    *
-   * @param typeName the name of the type that cannot be extended
+   * Parameters:
+   * 0: the name of the type that cannot be extended
+   *
    * See [IMPLEMENTS_DISALLOWED_CLASS].
    */
   static const CompileTimeErrorCode EXTENDS_DISALLOWED_CLASS =
       const CompileTimeErrorCode(
           'EXTENDS_DISALLOWED_CLASS', "Classes cannot extend '{0}'");
 
   /**
    * 7.9 Superclasses: It is a compile-time error if the extends clause of a
    * class <i>C</i> includes a deferred type expression.
    *
-   * @param typeName the name of the type that cannot be extended
+   * Parameters:
+   * 0: the name of the type that cannot be extended
+   *
    * See [IMPLEMENTS_DEFERRED_CLASS], and [MIXIN_DEFERRED_CLASS].
    */
   static const CompileTimeErrorCode EXTENDS_DEFERRED_CLASS =
       const CompileTimeErrorCode('EXTENDS_DEFERRED_CLASS',
           "This class cannot extend the deferred class '{0}'");
 
   /**
    * 12.14.2 Binding Actuals to Formals: It is a static warning if <i>m &lt;
    * h</i> or if <i>m &gt; n</i>.
    *
    * 12.11.2 Const: It is a compile-time error if evaluation of a constant
    * object results in an uncaught exception being thrown.
    *
-   * @param requiredCount the maximum number of positional arguments
-   * @param argumentCount the actual number of positional arguments given
+   * Parameters:
+   * 0: the maximum number of positional arguments
+   * 1: the actual number of positional arguments given
    */
   static const CompileTimeErrorCode EXTRA_POSITIONAL_ARGUMENTS =
       const CompileTimeErrorCode('EXTRA_POSITIONAL_ARGUMENTS',
           "{0} positional arguments expected, but {1} found");
 
   /**
    * 7.6.1 Generative Constructors: Let <i>k</i> be a generative constructor. It
    * is a compile time error if more than one initializer corresponding to a
    * given instance variable appears in <i>k</i>'s list.
    */
@@ skipping 10 matching lines @@
   static const CompileTimeErrorCode FIELD_INITIALIZED_IN_PARAMETER_AND_INITIALIZER =
       const CompileTimeErrorCode(
           'FIELD_INITIALIZED_IN_PARAMETER_AND_INITIALIZER',
           "Fields cannot be initialized in both the parameter list and the initializers");
 
   /**
    * 5 Variables: It is a compile-time error if a final instance variable that
    * has is initialized by means of an initializing formal of a constructor is
    * also initialized elsewhere in the same constructor.
    *
-   * @param name the name of the field in question
+   * Parameters:
+   * 0: the name of the field in question
    */
   static const CompileTimeErrorCode FINAL_INITIALIZED_MULTIPLE_TIMES =
       const CompileTimeErrorCode('FINAL_INITIALIZED_MULTIPLE_TIMES',
           "'{0}' is a final field and so can only be set once");
 
   /**
    * 7.6.1 Generative Constructors: It is a compile-time error if an
    * initializing formal is used by a function other than a non-redirecting
    * generative constructor.
    */
@@ skipping 19 matching lines @@
    * generative constructor.
    */
   static const CompileTimeErrorCode FIELD_INITIALIZER_REDIRECTING_CONSTRUCTOR =
       const CompileTimeErrorCode('FIELD_INITIALIZER_REDIRECTING_CONSTRUCTOR',
           "The redirecting constructor cannot have a field initializer");
 
   /**
    * 7.2 Getters: It is a compile-time error if a class has both a getter and a
    * method with the same name.
    *
-   * @param name the conflicting name of the getter and method
+   * Parameters:
+   * 0: the conflicting name of the getter and method
    */
   static const CompileTimeErrorCode GETTER_AND_METHOD_WITH_SAME_NAME =
       const CompileTimeErrorCode('GETTER_AND_METHOD_WITH_SAME_NAME',
           "'{0}' cannot be used to name a getter, there is already a method with the same name");
 
   /**
    * 7.10 Superinterfaces: It is a compile-time error if the implements clause
    * of a class <i>C</i> specifies a malformed type or deferred type as a
    * superinterface.
    *
-   * @param typeName the name of the type that cannot be extended
+   * Parameters:
+   * 0: the name of the type that cannot be extended
+   *
    * See [EXTENDS_DEFERRED_CLASS], and [MIXIN_DEFERRED_CLASS].
    */
   static const CompileTimeErrorCode IMPLEMENTS_DEFERRED_CLASS =
       const CompileTimeErrorCode('IMPLEMENTS_DEFERRED_CLASS',
           "This class cannot implement the deferred class '{0}'");
 
   /**
    * 12.2 Null: It is a compile-time error for a class to attempt to extend or
    * implement Null.
    *
    * 12.3 Numbers: It is a compile-time error for a class to attempt to extend
    * or implement int.
    *
    * 12.3 Numbers: It is a compile-time error for a class to attempt to extend
    * or implement double.
    *
    * 12.3 Numbers: It is a compile-time error for any type other than the types
    * int and double to
    * attempt to extend or implement num.
    *
    * 12.4 Booleans: It is a compile-time error for a class to attempt to extend
    * or implement bool.
    *
    * 12.5 Strings: It is a compile-time error for a class to attempt to extend
    * or implement String.
    *
-   * @param typeName the name of the type that cannot be implemented
+   * Parameters:
+   * 0: the name of the type that cannot be implemented
+   *
    * See [EXTENDS_DISALLOWED_CLASS].
    */
   static const CompileTimeErrorCode IMPLEMENTS_DISALLOWED_CLASS =
       const CompileTimeErrorCode(
           'IMPLEMENTS_DISALLOWED_CLASS', "Classes cannot implement '{0}'");
 
   /**
    * 7.10 Superinterfaces: It is a compile-time error if the implements clause
    * of a class includes type dynamic.
    */
   static const CompileTimeErrorCode IMPLEMENTS_DYNAMIC =
       const CompileTimeErrorCode(
           'IMPLEMENTS_DYNAMIC', "Classes cannot implement 'dynamic'");
 
   /**
    * Enum proposal: It is a compile-time error to subclass, mix-in or implement
    * an enum.
    */
   static const CompileTimeErrorCode IMPLEMENTS_ENUM =
       const CompileTimeErrorCode(
           'IMPLEMENTS_ENUM', "Classes cannot implement an enum");
 
   /**
    * 7.10 Superinterfaces: It is a compile-time error if the implements clause
    * of a class <i>C</i> includes a type expression that does not denote a class
    * available in the lexical scope of <i>C</i>.
    *
-   * @param typeName the name of the interface that was not found
+   * Parameters:
+   * 0: the name of the interface that was not found
    */
   static const CompileTimeErrorCode IMPLEMENTS_NON_CLASS =
       const CompileTimeErrorCode(
           'IMPLEMENTS_NON_CLASS', "Classes can only implement other classes");
 
   /**
    * 7.10 Superinterfaces: It is a compile-time error if a type <i>T</i> appears
    * more than once in the implements clause of a class.
    *
-   * @param className the name of the class that is implemented more than once
+   * Parameters:
+   * 0: the name of the class that is implemented more than once
    */
   static const CompileTimeErrorCode IMPLEMENTS_REPEATED =
       const CompileTimeErrorCode(
           'IMPLEMENTS_REPEATED', "'{0}' can only be implemented once");
 
   /**
    * 7.10 Superinterfaces: It is a compile-time error if the superclass of a
    * class <i>C</i> appears in the implements clause of <i>C</i>.
    *
-   * @param className the name of the class that appears in both "extends" and
-   *        "implements" clauses
+   * Parameters:
+   * 0: the name of the class that appears in both "extends" and "implements"
+   *    clauses
    */
   static const CompileTimeErrorCode IMPLEMENTS_SUPER_CLASS =
       const CompileTimeErrorCode('IMPLEMENTS_SUPER_CLASS',
           "'{0}' cannot be used in both 'extends' and 'implements' clauses");
 
   /**
    * 7.6.1 Generative Constructors: Note that <b>this</b> is not in scope on the
    * right hand side of an initializer.
    *
    * 12.10 This: It is a compile-time error if this appears in a top-level
    * function or variable initializer, in a factory constructor, or in a static
    * method or variable initializer, or in the initializer of an instance
    * variable.
    *
-   * @param name the name of the type in question
+   * Parameters:
+   * 0: the name of the type in question
    */
   static const CompileTimeErrorCode IMPLICIT_THIS_REFERENCE_IN_INITIALIZER =
       const CompileTimeErrorCode('IMPLICIT_THIS_REFERENCE_IN_INITIALIZER',
           "Only static members can be accessed in initializers");
 
   /**
    * SDK implementation libraries can be imported only by other SDK libraries.
    *
-   * @param uri the uri pointing to a library
+   * Parameters:
+   * 0: the uri pointing to a library
    */
   static const CompileTimeErrorCode IMPORT_INTERNAL_LIBRARY =
       const CompileTimeErrorCode('IMPORT_INTERNAL_LIBRARY',
           "The library '{0}' is internal and cannot be imported");
 
   /**
    * 14.1 Imports: It is a compile-time error if the specified URI of an
    * immediate import does not refer to a library declaration.
    *
-   * @param uri the uri pointing to a non-library declaration
+   * Parameters:
+   * 0: the uri pointing to a non-library declaration
+   *
    * See [StaticWarningCode.IMPORT_OF_NON_LIBRARY].
    */
   static const CompileTimeErrorCode IMPORT_OF_NON_LIBRARY =
       const CompileTimeErrorCode('IMPORT_OF_NON_LIBRARY',
           "The imported library '{0}' must not have a part-of directive");
 
   /**
    * 13.9 Switch: It is a compile-time error if values of the expressions
    * <i>e<sub>k</sub></i> are not instances of the same class <i>C</i>, for all
    * <i>1 &lt;= k &lt;= n</i>.
    *
-   * @param expressionSource the expression source code that is the unexpected
-   *        type
-   * @param expectedType the name of the expected type
+   * Parameters:
+   * 0: the expression source code that is the unexpected type
+   * 1: the name of the expected type
    */
   static const CompileTimeErrorCode INCONSISTENT_CASE_EXPRESSION_TYPES =
       const CompileTimeErrorCode('INCONSISTENT_CASE_EXPRESSION_TYPES',
           "Case expressions must have the same types, '{0}' is not a '{1}'");
 
   /**
    * 7.6.1 Generative Constructors: Let <i>k</i> be a generative constructor. It
    * is a compile-time error if <i>k</i>'s initializer list contains an
    * initializer for a variable that is not an instance variable declared in the
    * immediately surrounding class.
    *
-   * @param id the name of the initializing formal that is not an instance
-   *        variable in the immediately enclosing class
+   * Parameters:
+   * 0: the name of the initializing formal that is not an instance variable in
+   *    the immediately enclosing class
+   *
    * See [INITIALIZING_FORMAL_FOR_NON_EXISTENT_FIELD].
    */
   static const CompileTimeErrorCode INITIALIZER_FOR_NON_EXISTENT_FIELD =
       const CompileTimeErrorCode('INITIALIZER_FOR_NON_EXISTENT_FIELD',
           "'{0}' is not a variable in the enclosing class");
 
   /**
    * 7.6.1 Generative Constructors: Let <i>k</i> be a generative constructor. It
    * is a compile-time error if <i>k</i>'s initializer list contains an
    * initializer for a variable that is not an instance variable declared in the
    * immediately surrounding class.
    *
-   * @param id the name of the initializing formal that is a static variable in
-   *        the immediately enclosing class
+   * Parameters:
+   * 0: the name of the initializing formal that is a static variable in the
+   *    immediately enclosing class
+   *
    * See [INITIALIZING_FORMAL_FOR_STATIC_FIELD].
    */
   static const CompileTimeErrorCode INITIALIZER_FOR_STATIC_FIELD =
       const CompileTimeErrorCode('INITIALIZER_FOR_STATIC_FIELD',
           "'{0}' is a static variable in the enclosing class, variables initialized in a constructor cannot be static");
 
   /**
    * 7.6.1 Generative Constructors: An initializing formal has the form
    * <i>this.id</i>. It is a compile-time error if <i>id</i> is not the name of
    * an instance variable of the immediately enclosing class.
    *
-   * @param id the name of the initializing formal that is not an instance
-   *        variable in the immediately enclosing class
+   * Parameters:
+   * 0: the name of the initializing formal that is not an instance variable in
+   *    the immediately enclosing class
+   *
    * See [INITIALIZING_FORMAL_FOR_STATIC_FIELD], and
    * [INITIALIZER_FOR_NON_EXISTENT_FIELD].
    */
   static const CompileTimeErrorCode INITIALIZING_FORMAL_FOR_NON_EXISTENT_FIELD =
       const CompileTimeErrorCode('INITIALIZING_FORMAL_FOR_NON_EXISTENT_FIELD',
           "'{0}' is not a variable in the enclosing class");
 
   /**
    * 7.6.1 Generative Constructors: An initializing formal has the form
    * <i>this.id</i>. It is a compile-time error if <i>id</i> is not the name of
    * an instance variable of the immediately enclosing class.
    *
-   * @param id the name of the initializing formal that is a static variable in
-   *        the immediately enclosing class
+   * Parameters:
+   * 0: the name of the initializing formal that is a static variable in the
+   *    immediately enclosing class
+   *
    * See [INITIALIZER_FOR_STATIC_FIELD].
    */
   static const CompileTimeErrorCode INITIALIZING_FORMAL_FOR_STATIC_FIELD =
       const CompileTimeErrorCode('INITIALIZING_FORMAL_FOR_STATIC_FIELD',
           "'{0}' is a static field in the enclosing class, fields initialized in a constructor cannot be static");
 
   /**
    * 12.30 Identifier Reference: Otherwise, e is equivalent to the property
    * extraction <b>this</b>.<i>id</i>.
    */
@@ skipping 98 matching lines @@
    * variable.
    */
   static const CompileTimeErrorCode INVALID_REFERENCE_TO_THIS =
       const CompileTimeErrorCode('INVALID_REFERENCE_TO_THIS',
           "Invalid reference to 'this' expression");
 
   /**
    * 12.6 Lists: It is a compile time error if the type argument of a constant
    * list literal includes a type parameter.
    *
-   * @name the name of the type parameter
+   * Parameters:
+   * 0: the name of the type parameter
    */
   static const CompileTimeErrorCode INVALID_TYPE_ARGUMENT_IN_CONST_LIST =
       const CompileTimeErrorCode('INVALID_TYPE_ARGUMENT_IN_CONST_LIST',
           "Constant list literals cannot include a type parameter as a type argument, such as '{0}'");
 
   /**
    * 12.7 Maps: It is a compile time error if the type arguments of a constant
    * map literal include a type parameter.
    *
-   * @name the name of the type parameter
+   * Parameters:
+   * 0: the name of the type parameter
    */
   static const CompileTimeErrorCode INVALID_TYPE_ARGUMENT_IN_CONST_MAP =
       const CompileTimeErrorCode('INVALID_TYPE_ARGUMENT_IN_CONST_MAP',
           "Constant map literals cannot include a type parameter as a type argument, such as '{0}'");
 
   /**
    * 14.2 Exports: It is a compile-time error if the compilation unit found at
    * the specified URI is not a library declaration.
    *
    * 14.1 Imports: It is a compile-time error if the compilation unit found at
    * the specified URI is not a library declaration.
    *
    * 14.3 Parts: It is a compile time error if the contents of the URI are not a
    * valid part declaration.
    *
-   * @param uri the URI that is invalid
+   * Parameters:
+   * 0: the URI that is invalid
+   *
    * See [URI_DOES_NOT_EXIST].
    */
   static const CompileTimeErrorCode INVALID_URI =
       const CompileTimeErrorCode('INVALID_URI', "Invalid URI syntax: '{0}'");
 
   /**
    * 13.13 Break: It is a compile-time error if no such statement
    * <i>s<sub>E</sub></i> exists within the innermost function in which
    * <i>s<sub>b</sub></i> occurs.
    *
    * 13.14 Continue: It is a compile-time error if no such statement or case
    * clause <i>s<sub>E</sub></i> exists within the innermost function in which
    * <i>s<sub>c</sub></i> occurs.
    *
-   * @param labelName the name of the unresolvable label
+   * Parameters:
+   * 0: the name of the unresolvable label
    */
   static const CompileTimeErrorCode LABEL_IN_OUTER_SCOPE =
       const CompileTimeErrorCode('LABEL_IN_OUTER_SCOPE',
           "Cannot reference label '{0}' declared in an outer method");
 
   /**
    * 13.13 Break: It is a compile-time error if no such statement
    * <i>s<sub>E</sub></i> exists within the innermost function in which
    * <i>s<sub>b</sub></i> occurs.
    *
    * 13.14 Continue: It is a compile-time error if no such statement or case
    * clause <i>s<sub>E</sub></i> exists within the innermost function in which
    * <i>s<sub>c</sub></i> occurs.
    *
-   * @param labelName the name of the unresolvable label
+   * Parameters:
+   * 0: the name of the unresolvable label
    */
   static const CompileTimeErrorCode LABEL_UNDEFINED =
       const CompileTimeErrorCode(
           'LABEL_UNDEFINED', "Cannot reference undefined label '{0}'");
 
   /**
    * 7 Classes: It is a compile time error if a class <i>C</i> declares a member
    * with the same name as <i>C</i>.
    */
   static const CompileTimeErrorCode MEMBER_WITH_CLASS_NAME =
       const CompileTimeErrorCode('MEMBER_WITH_CLASS_NAME',
           "Class members cannot have the same name as the enclosing class");
 
   /**
    * 7.2 Getters: It is a compile-time error if a class has both a getter and a
    * method with the same name.
    *
-   * @param name the conflicting name of the getter and method
+   * Parameters:
+   * 0: the conflicting name of the getter and method
    */
   static const CompileTimeErrorCode METHOD_AND_GETTER_WITH_SAME_NAME =
       const CompileTimeErrorCode('METHOD_AND_GETTER_WITH_SAME_NAME',
           "'{0}' cannot be used to name a method, there is already a getter with the same name");
 
   /**
    * 12.1 Constants: A constant expression is ... a constant list literal.
    */
   static const CompileTimeErrorCode MISSING_CONST_IN_LIST_LITERAL =
       const CompileTimeErrorCode('MISSING_CONST_IN_LIST_LITERAL',
           "List literals must be prefixed with 'const' when used as a constant expression");
 
   /**
    * 12.1 Constants: A constant expression is ... a constant map literal.
    */
   static const CompileTimeErrorCode MISSING_CONST_IN_MAP_LITERAL =
       const CompileTimeErrorCode('MISSING_CONST_IN_MAP_LITERAL',
           "Map literals must be prefixed with 'const' when used as a constant expression");
 
   /**
    * Enum proposal: It is a static warning if all of the following conditions
    * hold:
    * * The switch statement does not have a 'default' clause.
    * * The static type of <i>e</i> is an enumerated typed with elements
    *   <i>id<sub>1</sub></i>, &hellip;, <i>id<sub>n</sub></i>.
    * * The sets {<i>e<sub>1</sub></i>, &hellip;, <i>e<sub>k</sub></i>} and
-   *   {<i>id<sub>1</sub></i>, &hellip;, <i>id<sub>n</sub></i>} are not the same.
+   *   {<i>id<sub>1</sub></i>, &hellip;, <i>id<sub>n</sub></i>} are not the
+   *   same.
    *
-   * @param constantName the name of the constant that is missing
+   * Parameters:
+   * 0: the name of the constant that is missing
    */
   static const CompileTimeErrorCode MISSING_ENUM_CONSTANT_IN_SWITCH =
       const CompileTimeErrorCode('MISSING_ENUM_CONSTANT_IN_SWITCH',
           "Missing case clause for '{0}'",
           "Add a case clause for the missing constant or add a default clause.");
 
   /**
    * 9 Mixins: It is a compile-time error if a declared or derived mixin
    * explicitly declares a constructor.
    *
-   * @param typeName the name of the mixin that is invalid
+   * Parameters:
+   * 0: the name of the mixin that is invalid
    */
   static const CompileTimeErrorCode MIXIN_DECLARES_CONSTRUCTOR =
       const CompileTimeErrorCode('MIXIN_DECLARES_CONSTRUCTOR',
           "The class '{0}' cannot be used as a mixin because it declares a constructor");
 
   /**
    * 9.1 Mixin Application: It is a compile-time error if the with clause of a
    * mixin application <i>C</i> includes a deferred type expression.
    *
-   * @param typeName the name of the type that cannot be extended
+   * Parameters:
+   * 0: the name of the type that cannot be extended
+   *
    * See [EXTENDS_DEFERRED_CLASS], and [IMPLEMENTS_DEFERRED_CLASS].
    */
   static const CompileTimeErrorCode MIXIN_DEFERRED_CLASS =
       const CompileTimeErrorCode('MIXIN_DEFERRED_CLASS',
           "This class cannot mixin the deferred class '{0}'");
 
   /**
    * Not yet in the spec, but consistent with VM behavior.  It is a
    * compile-time error if all of the constructors of a mixin's base class have
    * at least one optional parameter (since only constructors that lack
    * optional parameters can be forwarded to the mixin).  See
    * https://code.google.com/p/dart/issues/detail?id=15101#c4
    */
   static const CompileTimeErrorCode MIXIN_HAS_NO_CONSTRUCTORS =
       const CompileTimeErrorCode('MIXIN_HAS_NO_CONSTRUCTORS',
           "This mixin application is invalid because all of the constructors "
           "in the base class '{0}' have optional parameters.");
 
   /**
    * 9 Mixins: It is a compile-time error if a mixin is derived from a class
    * whose superclass is not Object.
    *
-   * @param typeName the name of the mixin that is invalid
+   * Parameters:
+   * 0: the name of the mixin that is invalid
    */
   static const CompileTimeErrorCode MIXIN_INHERITS_FROM_NOT_OBJECT =
       const CompileTimeErrorCode('MIXIN_INHERITS_FROM_NOT_OBJECT',
           "The class '{0}' cannot be used as a mixin because it extends a class other than Object");
 
   /**
    * 12.2 Null: It is a compile-time error for a class to attempt to extend or
    * implement Null.
    *
    * 12.3 Numbers: It is a compile-time error for a class to attempt to extend
    * or implement int.
    *
    * 12.3 Numbers: It is a compile-time error for a class to attempt to extend
    * or implement double.
    *
    * 12.3 Numbers: It is a compile-time error for any type other than the types
    * int and double to attempt to extend or implement num.
    *
    * 12.4 Booleans: It is a compile-time error for a class to attempt to extend
    * or implement bool.
    *
    * 12.5 Strings: It is a compile-time error for a class to attempt to extend
    * or implement String.
    *
-   * @param typeName the name of the type that cannot be extended
+   * Parameters:
+   * 0: the name of the type that cannot be extended
+   *
    * See [IMPLEMENTS_DISALLOWED_CLASS].
    */
   static const CompileTimeErrorCode MIXIN_OF_DISALLOWED_CLASS =
       const CompileTimeErrorCode(
           'MIXIN_OF_DISALLOWED_CLASS', "Classes cannot mixin '{0}'");
 
   /**
    * Enum proposal: It is a compile-time error to subclass, mix-in or implement
    * an enum.
    */
@@ skipping 234 matching lines @@
           'NON_CONSTANT_VALUE_IN_INITIALIZER_FROM_DEFERRED_LIBRARY',
           "Constant values from a deferred library cannot be used as constant initializers");
 
   /**
    * 12.14.2 Binding Actuals to Formals: It is a static warning if <i>m < h</i>
    * or if <i>m > n</i>.
    *
    * 12.11.2 Const: It is a compile-time error if evaluation of a constant
    * object results in an uncaught exception being thrown.
    *
-   * @param requiredCount the expected number of required arguments
-   * @param argumentCount the actual number of positional arguments given
+   * Parameters:
+   * 0: the expected number of required arguments
+   * 1: the actual number of positional arguments given
    */
   static const CompileTimeErrorCode NOT_ENOUGH_REQUIRED_ARGUMENTS =
       const CompileTimeErrorCode('NOT_ENOUGH_REQUIRED_ARGUMENTS',
           "{0} required argument(s) expected, but {1} found");
 
   /**
    * 7.6.1 Generative Constructors: Let <i>C</i> be the class in which the
    * superinitializer appears and let <i>S</i> be the superclass of <i>C</i>.
    * Let <i>k</i> be a generative constructor. It is a compile-time error if
    * class <i>S</i> does not declare a generative constructor named <i>S</i>
@@ skipping 15 matching lines @@
    * parameter in an operator.
    */
   static const CompileTimeErrorCode OPTIONAL_PARAMETER_IN_OPERATOR =
       const CompileTimeErrorCode('OPTIONAL_PARAMETER_IN_OPERATOR',
           "Optional parameters are not allowed when defining an operator");
 
   /**
    * 14.3 Parts: It is a compile time error if the contents of the URI are not a
    * valid part declaration.
    *
-   * @param uri the uri pointing to a non-library declaration
+   * Parameters:
+   * 0: the uri pointing to a non-library declaration
    */
   static const CompileTimeErrorCode PART_OF_NON_PART =
       const CompileTimeErrorCode('PART_OF_NON_PART',
           "The included part '{0}' must have a part-of directive");
 
   /**
    * 14.1 Imports: It is a compile-time error if the current library declares a
    * top-level member named <i>p</i>.
    */
   static const CompileTimeErrorCode PREFIX_COLLIDES_WITH_TOP_LEVEL_MEMBER =
@@ skipping 41 matching lines @@
   /**
    * 7.10 Superinterfaces: It is a compile-time error if the interface of a
    * class <i>C</i> is a superinterface of itself.
    *
    * 8.1 Superinterfaces: It is a compile-time error if an interface is a
    * superinterface of itself.
    *
    * 7.9 Superclasses: It is a compile-time error if a class <i>C</i> is a
    * superclass of itself.
    *
-   * @param className the name of the class that implements itself recursively
-   * @param strImplementsPath a string representation of the implements loop
+   * Parameters:
+   * 0: the name of the class that implements itself recursively
+   * 1: a string representation of the implements loop
    */
   static const CompileTimeErrorCode RECURSIVE_INTERFACE_INHERITANCE =
       const CompileTimeErrorCode('RECURSIVE_INTERFACE_INHERITANCE',
           "'{0}' cannot be a superinterface of itself: {1}");
 
   /**
    * 7.10 Superinterfaces: It is a compile-time error if the interface of a
    * class <i>C</i> is a superinterface of itself.
    *
    * 8.1 Superinterfaces: It is a compile-time error if an interface is a
    * superinterface of itself.
    *
    * 7.9 Superclasses: It is a compile-time error if a class <i>C</i> is a
    * superclass of itself.
    *
-   * @param className the name of the class that implements itself recursively
+   * Parameters:
+   * 0: the name of the class that implements itself recursively
    */
   static const CompileTimeErrorCode RECURSIVE_INTERFACE_INHERITANCE_BASE_CASE_EXTENDS =
       const CompileTimeErrorCode(
           'RECURSIVE_INTERFACE_INHERITANCE_BASE_CASE_EXTENDS',
           "'{0}' cannot extend itself");
 
   /**
    * 7.10 Superinterfaces: It is a compile-time error if the interface of a
    * class <i>C</i> is a superinterface of itself.
    *
    * 8.1 Superinterfaces: It is a compile-time error if an interface is a
    * superinterface of itself.
    *
    * 7.9 Superclasses: It is a compile-time error if a class <i>C</i> is a
    * superclass of itself.
    *
-   * @param className the name of the class that implements itself recursively
+   * Parameters:
+   * 0: the name of the class that implements itself recursively
    */
   static const CompileTimeErrorCode RECURSIVE_INTERFACE_INHERITANCE_BASE_CASE_IMPLEMENTS =
       const CompileTimeErrorCode(
           'RECURSIVE_INTERFACE_INHERITANCE_BASE_CASE_IMPLEMENTS',
           "'{0}' cannot implement itself");
 
   /**
    * 7.10 Superinterfaces: It is a compile-time error if the interface of a
    * class <i>C</i> is a superinterface of itself.
    *
    * 8.1 Superinterfaces: It is a compile-time error if an interface is a
    * superinterface of itself.
    *
    * 7.9 Superclasses: It is a compile-time error if a class <i>C</i> is a
    * superclass of itself.
    *
-   * @param className the name of the class that implements itself recursively
+   * Parameters:
+   * 0: the name of the class that implements itself recursively
    */
   static const CompileTimeErrorCode RECURSIVE_INTERFACE_INHERITANCE_BASE_CASE_WITH =
       const CompileTimeErrorCode(
           'RECURSIVE_INTERFACE_INHERITANCE_BASE_CASE_WITH',
           "'{0}' cannot use itself as a mixin");
 
   /**
    * 7.6.2 Factories: It is a compile-time error if <i>k</i> is prefixed with
    * the const modifier but <i>k'</i> is not a constant constructor.
    */
@@ skipping 111 matching lines @@
    * arguments to a constructor of a generic type <i>G</i> invoked by a new
    * expression or a constant object expression are not subtypes of the bounds
    * of the corresponding formal type parameters of <i>G</i>.
    *
    * 12.11.1 New: If T is malformed a dynamic error occurs. In checked mode, if
    * T is mal-bounded a dynamic error occurs.
    *
    * 12.1 Constants: It is a compile-time error if evaluation of a compile-time
    * constant would raise an exception.
    *
-   * @param boundedTypeName the name of the type used in the instance creation
-   *        that should be limited by the bound as specified in the class
-   *        declaration
-   * @param boundingTypeName the name of the bounding type
+   * Parameters:
+   * 0: the name of the type used in the instance creation that should be
+   *    limited by the bound as specified in the class declaration
+   * 1: the name of the bounding type
+   *
    * See [StaticTypeWarningCode.TYPE_ARGUMENT_NOT_MATCHING_BOUNDS].
    */
   static const CompileTimeErrorCode TYPE_ARGUMENT_NOT_MATCHING_BOUNDS =
       const CompileTimeErrorCode(
           'TYPE_ARGUMENT_NOT_MATCHING_BOUNDS', "'{0}' does not extend '{1}'");
 
   /**
    * 15.3.1 Typedef: Any self reference, either directly, or recursively via
    * another typedef, is a compile time error.
    */
@@ skipping 32 matching lines @@
 
   /**
    * 12.14.2 Binding Actuals to Formals: Furthermore, each <i>q<sub>i</sub></i>,
    * <i>1<=i<=l</i>, must have a corresponding named parameter in the set
    * {<i>p<sub>n+1</sub></i> ... <i>p<sub>n+k</sub></i>} or a static warning
    * occurs.
    *
    * 12.11.2 Const: It is a compile-time error if evaluation of a constant
    * object results in an uncaught exception being thrown.
    *
-   * @param name the name of the requested named parameter
+   * Parameters:
+   * 0: the name of the requested named parameter
    */
   static const CompileTimeErrorCode UNDEFINED_NAMED_PARAMETER =
       const CompileTimeErrorCode('UNDEFINED_NAMED_PARAMETER',
           "The named parameter '{0}' is not defined");
 
   /**
    * 14.2 Exports: It is a compile-time error if the compilation unit found at
    * the specified URI is not a library declaration.
    *
    * 14.1 Imports: It is a compile-time error if the compilation unit found at
    * the specified URI is not a library declaration.
    *
    * 14.3 Parts: It is a compile time error if the contents of the URI are not a
    * valid part declaration.
    *
-   * @param uri the URI pointing to a non-existent file
+   * Parameters:
+   * 0: the URI pointing to a non-existent file
+   *
    * See [INVALID_URI].
    */
   static const CompileTimeErrorCode URI_DOES_NOT_EXIST =
       const CompileTimeErrorCode(
           'URI_DOES_NOT_EXIST', "Target of URI does not exist: '{0}'");
 
   /**
    * 14.1 Imports: It is a compile-time error if <i>x</i> is not a compile-time
    * constant, or if <i>x</i> involves string interpolation.
    *
@@ skipping 10 matching lines @@
 
   /**
    * 7.1.1 Operators: It is a compile-time error if the arity of the
    * user-declared operator []= is not 2. It is a compile time error if the
    * arity of a user-declared operator with one of the names: &lt;, &gt;, &lt;=,
    * &gt;=, ==, +, /, ~/, *, %, |, ^, &, &lt;&lt;, &gt;&gt;, [] is not 1. It is
    * a compile time error if the arity of the user-declared operator - is not 0
    * or 1. It is a compile time error if the arity of the user-declared operator
    * ~ is not 0.
    *
-   * @param operatorName the name of the declared operator
-   * @param expectedNumberOfParameters the number of parameters expected
-   * @param actualNumberOfParameters the number of parameters found in the
-   *        operator declaration
+   * Parameters:
+   * 0: the name of the declared operator
+   * 1: the number of parameters expected
+   * 2: the number of parameters found in the operator declaration
    */
   static const CompileTimeErrorCode WRONG_NUMBER_OF_PARAMETERS_FOR_OPERATOR =
       const CompileTimeErrorCode('WRONG_NUMBER_OF_PARAMETERS_FOR_OPERATOR',
           "Operator '{0}' should declare exactly {1} parameter(s), but {2} found");
 
   /**
    * 7.1.1 Operators: It is a compile time error if the arity of the
    * user-declared operator - is not 0 or 1.
    *
-   * @param actualNumberOfParameters the number of parameters found in the
-   *        operator declaration
+   * Parameters:
+   * 0: the number of parameters found in the operator declaration
    */
   static const CompileTimeErrorCode WRONG_NUMBER_OF_PARAMETERS_FOR_OPERATOR_MINUS =
       const CompileTimeErrorCode(
           'WRONG_NUMBER_OF_PARAMETERS_FOR_OPERATOR_MINUS',
           "Operator '-' should declare 0 or 1 parameter, but {0} found");
 
   /**
    * 7.3 Setters: It is a compile-time error if a setter's formal parameter list
    * does not include exactly one required formal parameter <i>p</i>.
    */
@@ skipping 27 matching lines @@
       : super(name, message, correction);
 
   @override
   ErrorSeverity get errorSeverity => ErrorType.COMPILE_TIME_ERROR.severity;
 
   @override
   ErrorType get type => ErrorType.COMPILE_TIME_ERROR;
 }
 
 /**
- * An `ErrorCode` represents an error code associated with an [AnalysisError].
+ * An error code associated with an [AnalysisError].
  *
  * Generally, we want to provide messages that consist of three sentences. From
  * the user's perspective these sentences should explain:
  * 1. what is wrong,
  * 2. why is it wrong, and
  * 3. how do I fix it.
  * However, we combine the first two in the [message] and the last in the
  * [correction].
  */
 abstract class ErrorCode {
@@ skipping 38 matching lines @@
    */
   ErrorType get type;
 
   /**
    * The unique name of this error code.
    */
   String get uniqueName => "$runtimeType.$name";
 }
 
 /**
- * The enumeration `ErrorProperty` defines the properties that can be associated with an
- * [AnalysisError].
+ * The properties that can be associated with an [AnalysisError].
  */
 class ErrorProperty extends Enum<ErrorProperty> {
   /**
    * A property whose value is an array of [ExecutableElement] that should
    * be but are not implemented by a concrete class.
    */
   static const ErrorProperty UNIMPLEMENTED_METHODS =
       const ErrorProperty('UNIMPLEMENTED_METHODS', 0);
 
   static const List<ErrorProperty> values = const [UNIMPLEMENTED_METHODS];
 
   const ErrorProperty(String name, int ordinal) : super(name, ordinal);
 }
 
 /**
- * Instances of the class `ErrorReporter` wrap an error listener with utility methods used to
- * create the errors being reported.
+ * An object used to create analysis errors and report then to an error
+ * listener.
  */
 class ErrorReporter {
   /**
    * The error listener to which errors will be reported.
    */
   final AnalysisErrorListener _errorListener;
 
   /**
    * The default source to be used when reporting errors.
    */
   final Source _defaultSource;
 
   /**
    * The source to be used when reporting errors.
    */
   Source _source;
 
   /**
-   * Initialize a newly created error reporter that will report errors to the given listener.
-   *
-   * @param errorListener the error listener to which errors will be reported
-   * @param defaultSource the default source to be used when reporting errors
+   * Initialize a newly created error reporter that will report errors to the
+   * given [_errorListener]. Errors will be reported against the
+   * [_defaultSource] unless another source is provided later.
    */
   ErrorReporter(this._errorListener, this._defaultSource) {
     if (_errorListener == null) {
       throw new IllegalArgumentException("An error listener must be provided");
     } else if (_defaultSource == null) {
       throw new IllegalArgumentException("A default source must be provided");
     }
     this._source = _defaultSource;
   }
 
   Source get source => _source;
 
   /**
-   * Set the source to be used when reporting errors. Setting the source to `null` will cause
-   * the default source to be used.
-   *
-   * @param source the source to be used when reporting errors
+   * Set the source to be used when reporting errors to the given [source].
+   * Setting the source to `null` will cause the default source to be used.
    */
   void set source(Source source) {
     this._source = source == null ? _defaultSource : source;
   }
 
   /**
-   * Creates an error with properties with the given error code and arguments.
-   *
-   * @param errorCode the error code of the error to be reported
-   * @param node the node specifying the location of the error
-   * @param arguments the arguments to the error, used to compose the error message
+   * Creates an error with properties with the given [errorCode] and
+   * [arguments]. The [node] is used to compute the location of the error.
    */
   AnalysisErrorWithProperties newErrorWithProperties(
           ErrorCode errorCode, AstNode node, List<Object> arguments) =>
       new AnalysisErrorWithProperties.con2(
           _source, node.offset, node.length, errorCode, arguments);
 
   /**
-   * Report a passed error.
-   *
-   * @param error the error to report
+   * Report the given [error].
    */
   void reportError(AnalysisError error) {
     _errorListener.onError(error);
   }
 
   /**
-   * Report an error with the given error code and arguments.
-   *
-   * @param errorCode the error code of the error to be reported
-   * @param element the element which name should be used as the location of the error
-   * @param arguments the arguments to the error, used to compose the error message
+   * Report an error with the given [errorCode] and [arguments]. The [element]
+   * is used to compute the location of the error.
    */
   void reportErrorForElement(
       ErrorCode errorCode, Element element, List<Object> arguments) {
     reportErrorForOffset(
         errorCode, element.nameOffset, element.displayName.length, arguments);
   }
 
   /**
-   * Report an error with the given error code and arguments.
+   * Report an error with the given [errorCode] and [arguments]. The [node] is
+   * used to compute the location of the error.
    *
    * If the arguments contain the names of two or more types, the method
    * [reportTypeErrorForNode] should be used and the types
    * themselves (rather than their names) should be passed as arguments.
-   *
-   * @param errorCode the error code of the error to be reported
-   * @param node the node specifying the location of the error
-   * @param arguments the arguments to the error, used to compose the error message
    */
   void reportErrorForNode(ErrorCode errorCode, AstNode node,
       [List<Object> arguments]) {
     reportErrorForOffset(errorCode, node.offset, node.length, arguments);
   }
 
   /**
-   * Report an error with the given error code and arguments.
-   *
-   * @param errorCode the error code of the error to be reported
-   * @param offset the offset of the location of the error
-   * @param length the length of the location of the error
-   * @param arguments the arguments to the error, used to compose the error message
+   * Report an error with the given [errorCode] and [arguments]. The location of
+   * the error is specified by the given [offset] and [length].
    */
   void reportErrorForOffset(ErrorCode errorCode, int offset, int length,
       [List<Object> arguments]) {
     _errorListener.onError(
         new AnalysisError.con2(_source, offset, length, errorCode, arguments));
   }
 
   /**
-   * Report an error with the given error code and arguments.
-   *
-   * @param errorCode the error code of the error to be reported
-   * @param token the token specifying the location of the error
-   * @param arguments the arguments to the error, used to compose the error message
+   * Report an error with the given [errorCode] and [arguments]. The [token] is
+   * used to compute the location of the error.
    */
   void reportErrorForToken(ErrorCode errorCode, Token token,
       [List<Object> arguments]) {
     reportErrorForOffset(errorCode, token.offset, token.length, arguments);
   }
 
   /**
-   * Report an error with the given error code and arguments. The arguments are expected to contain
-   * two or more types. Convert the types into strings by using the display names of the types,
-   * unless there are two or more types with the same names, in which case the extended display
-   * names of the types will be used in order to clarify the message.
+   * Report an error with the given [errorCode] and [arguments]. The [node] is
+   * used to compute the location of the error. The arguments are expected to
+   * contain two or more types. Convert the types into strings by using the
+   * display names of the types, unless there are two or more types with the
+   * same names, in which case the extended display names of the types will be
+   * used in order to clarify the message.
    *
    * If there are not two or more types in the argument list, the method
    * [reportErrorForNode] should be used instead.
-   *
-   * @param errorCode the error code of the error to be reported
-   * @param node the node specifying the location of the error
-   * @param arguments the arguments to the error, used to compose the error message
    */
   void reportTypeErrorForNode(
       ErrorCode errorCode, AstNode node, List<Object> arguments) {
     _convertTypeNames(arguments);
     reportErrorForOffset(errorCode, node.offset, node.length, arguments);
   }
 
   /**
-   * Given an array of arguments that is expected to contain two or more types, convert the types
-   * into strings by using the display names of the types, unless there are two or more types with
-   * the same names, in which case the extended display names of the types will be used in order to
+   * Given an array of [arguments] that is expected to contain two or more
+   * types, convert the types into strings by using the display names of the
+   * types, unless there are two or more types with the same names, in which
+   * case the extended display names of the types will be used in order to
    * clarify the message.
-   *
-   * @param arguments the arguments that are to be converted
    */
   void _convertTypeNames(List<Object> arguments) {
     if (_hasEqualTypeNames(arguments)) {
       int count = arguments.length;
       for (int i = 0; i < count; i++) {
         Object argument = arguments[i];
         if (argument is DartType) {
           DartType type = argument;
           Element element = type.element;
           if (element == null) {
             arguments[i] = type.displayName;
           } else {
             arguments[i] = element.getExtendedDisplayName(type.displayName);
           }
         }
       }
     } else {
       int count = arguments.length;
       for (int i = 0; i < count; i++) {
         Object argument = arguments[i];
         if (argument is DartType) {
           arguments[i] = argument.displayName;
         }
       }
     }
   }
 
   /**
-   * Return `true` if the given array of arguments contains two or more types with the same
-   * display name.
-   *
-   * @param arguments the arguments being tested
-   * @return `true` if the array of arguments contains two or more types with the same display
-   *         name
+   * Return `true` if the given array of [arguments] contains two or more types
+   * with the same display name.
    */
   bool _hasEqualTypeNames(List<Object> arguments) {
     int count = arguments.length;
     HashSet<String> typeNames = new HashSet<String>();
     for (int i = 0; i < count; i++) {
       if (arguments[i] is DartType &&
           !typeNames.add((arguments[i] as DartType).displayName)) {
         return true;
       }
     }
     return false;
   }
 }
 
 /**
- * Instances of the enumeration `ErrorSeverity` represent the severity of an [ErrorCode]
- * .
+ * The severity of an [ErrorCode].
  */
 class ErrorSeverity extends Enum<ErrorSeverity> {
   /**
-   * The severity representing a non-error. This is never used for any error code, but is useful for
-   * clients.
+   * The severity representing a non-error. This is never used for any error
+   * code, but is useful for clients.
    */
   static const ErrorSeverity NONE = const ErrorSeverity('NONE', 0, " ", "none");
 
   /**
    * The severity representing an informational level analysis issue.
    */
   static const ErrorSeverity INFO = const ErrorSeverity('INFO', 1, "I", "info");
 
   /**
    * The severity representing a warning. Warnings can become errors if the `-Werror` command
@@ skipping 16 matching lines @@
   final String machineCode;
 
   /**
    * The name of the severity used when producing readable output.
    */
   final String displayName;
 
   /**
    * Initialize a newly created severity with the given names.
    *
-   * @param machineCode the name of the severity used when producing machine output
-   * @param displayName the name of the severity used when producing readable output
+   * Parameters:
+   * 0: the name of the severity used when producing machine output
+   * 1: the name of the severity used when producing readable output
    */
   const ErrorSeverity(
       String name, int ordinal, this.machineCode, this.displayName)
       : super(name, ordinal);
 
   /**
    * Return the severity constant that represents the greatest severity.
-   *
-   * @param severity the severity being compared against
-   * @return the most sever of this or the given severity
    */
   ErrorSeverity max(ErrorSeverity severity) =>
       this.ordinal >= severity.ordinal ? this : severity;
 }
 
 /**
- * Instances of the enumeration `ErrorType` represent the type of an [ErrorCode].
+ * The type of an [ErrorCode].
  */
 class ErrorType extends Enum<ErrorType> {
   /**
    * Task (todo) comments in user code.
    */
   static const ErrorType TODO = const ErrorType('TODO', 0, ErrorSeverity.INFO);
 
   /**
-   * Extra analysis run over the code to follow best practices, which are not in the Dart Language
-   * Specification.
+   * Extra analysis run over the code to follow best practices, which are not in
+   * the Dart Language Specification.
    */
   static const ErrorType HINT = const ErrorType('HINT', 1, ErrorSeverity.INFO);
 
   /**
-   * Compile-time errors are errors that preclude execution. A compile time error must be reported
-   * by a Dart compiler before the erroneous code is executed.
+   * Compile-time errors are errors that preclude execution. A compile time
+   * error must be reported by a Dart compiler before the erroneous code is
+   * executed.
    */
   static const ErrorType COMPILE_TIME_ERROR =
       const ErrorType('COMPILE_TIME_ERROR', 2, ErrorSeverity.ERROR);
 
   /**
-   * Checked mode compile-time errors are errors that preclude execution in checked mode.
+   * Checked mode compile-time errors are errors that preclude execution in
+   * checked mode.
    */
   static const ErrorType CHECKED_MODE_COMPILE_TIME_ERROR = const ErrorType(
       'CHECKED_MODE_COMPILE_TIME_ERROR', 3, ErrorSeverity.ERROR);
 
   /**
-   * Static warnings are those warnings reported by the static checker. They have no effect on
-   * execution. Static warnings must be provided by Dart compilers used during development.
+   * Static warnings are those warnings reported by the static checker. They
+   * have no effect on execution. Static warnings must be provided by Dart
+   * compilers used during development.
    */
   static const ErrorType STATIC_WARNING =
       const ErrorType('STATIC_WARNING', 4, ErrorSeverity.WARNING);
 
   /**
-   * Many, but not all, static warnings relate to types, in which case they are known as static type
-   * warnings.
+   * Many, but not all, static warnings relate to types, in which case they are
+   * known as static type warnings.
    */
   static const ErrorType STATIC_TYPE_WARNING =
       const ErrorType('STATIC_TYPE_WARNING', 5, ErrorSeverity.WARNING);
 
   /**
-   * Syntactic errors are errors produced as a result of input that does not conform to the grammar.
+   * Syntactic errors are errors produced as a result of input that does not
+   * conform to the grammar.
    */
   static const ErrorType SYNTACTIC_ERROR =
       const ErrorType('SYNTACTIC_ERROR', 6, ErrorSeverity.ERROR);
 
   /**
-   * Lint warnings describe style and best practice recommendations that can be used to formalize a project's style
-   * guidelines.
+   * Lint warnings describe style and best practice recommendations that can be
+   * used to formalize a project's style guidelines.
    */
   static const ErrorType LINT = const ErrorType('LINT', 7, ErrorSeverity.INFO);
 
   static const List<ErrorType> values = const [
     TODO,
     HINT,
     COMPILE_TIME_ERROR,
     CHECKED_MODE_COMPILE_TIME_ERROR,
     STATIC_WARNING,
     STATIC_TYPE_WARNING,
     SYNTACTIC_ERROR,
     LINT
   ];
 
   /**
    * The severity of this type of error.
    */
   final ErrorSeverity severity;
 
   /**
-   * Initialize a newly created error type to have the given severity.
-   *
-   * @param severity the severity of this type of error
+   * Initialize a newly created error type to have the given [name] and
+   * [severity].
    */
   const ErrorType(String name, int ordinal, this.severity)
       : super(name, ordinal);
 
   String get displayName => name.toLowerCase().replaceAll('_', ' ');
 }
 
 /**
- * The class `HintCode` defines the hints and coding recommendations for best
- * practices which are not mentioned in the Dart Language Specification.
+ * The hints and coding recommendations for best practices which are not
+ * mentioned in the Dart Language Specification.
  */
 class HintCode extends ErrorCode {
   /**
    * This hint is generated anywhere where the
    * [StaticWarningCode.ARGUMENT_TYPE_NOT_ASSIGNABLE] would have been generated,
    * if we used propagated information for the warnings.
    *
-   * @param actualType the name of the actual argument type
-   * @param expectedType the name of the expected type
+   * Parameters:
+   * 0: the name of the actual argument type
+   * 1: the name of the expected type
    */
   static const HintCode ARGUMENT_TYPE_NOT_ASSIGNABLE = const HintCode(
       'ARGUMENT_TYPE_NOT_ASSIGNABLE',
       "The argument type '{0}' cannot be assigned to the parameter type '{1}'");
 
   /**
    * Dead code is code that is never reached, this can happen for instance if a
    * statement follows a return statement.
    */
   static const HintCode DEAD_CODE = const HintCode('DEAD_CODE', "Dead code");
 
   /**
    * Dead code is code that is never reached. This case covers cases where the
    * user has catch clauses after `catch (e)` or `on Object catch (e)`.
    */
   static const HintCode DEAD_CODE_CATCH_FOLLOWING_CATCH = const HintCode(
       'DEAD_CODE_CATCH_FOLLOWING_CATCH',
       "Dead code, catch clauses after a 'catch (e)' or an 'on Object catch (e)' are never reached");
 
   /**
    * Dead code is code that is never reached. This case covers cases where the
    * user has an on-catch clause such as `on A catch (e)`, where a supertype of
    * `A` was already caught.
    *
-   * @param subtypeName name of the subtype
-   * @param supertypeName name of the supertype
+   * Parameters:
+   * 0: name of the subtype
+   * 1: name of the supertype
    */
   static const HintCode DEAD_CODE_ON_CATCH_SUBTYPE = const HintCode(
       'DEAD_CODE_ON_CATCH_SUBTYPE',
       "Dead code, this on-catch block will never be executed since '{0}' is a subtype of '{1}'");
 
   /**
    * Deprecated members should not be invoked or used.
    *
-   * @param memberName the name of the member
+   * Parameters:
+   * 0: the name of the member
    */
   static const HintCode DEPRECATED_MEMBER_USE =
       const HintCode('DEPRECATED_MEMBER_USE', "'{0}' is deprecated");
 
   /**
    * Duplicate imports.
    */
   static const HintCode DUPLICATE_IMPORT =
       const HintCode('DUPLICATE_IMPORT', "Duplicate import");
 
@@ skipping 33 matching lines @@
    */
   static const HintCode IMPORT_DEFERRED_LIBRARY_WITH_LOAD_FUNCTION = const HintCode(
       'IMPORT_DEFERRED_LIBRARY_WITH_LOAD_FUNCTION',
       "The library '{0}' defines a top-level function named 'loadLibrary' which is hidden by deferring this library");
 
   /**
    * This hint is generated anywhere where the
    * [StaticTypeWarningCode.INVALID_ASSIGNMENT] would have been generated, if we
    * used propagated information for the warnings.
    *
-   * @param rhsTypeName the name of the right hand side type
-   * @param lhsTypeName the name of the left hand side type
+   * Parameters:
+   * 0: the name of the right hand side type
+   * 1: the name of the left hand side type
    */
   static const HintCode INVALID_ASSIGNMENT = const HintCode(
       'INVALID_ASSIGNMENT',
       "A value of type '{0}' cannot be assigned to a variable of type '{1}'");
 
   /**
    * Generate a hint for methods or functions that have a return type, but do
    * not have a non-void return statement on all branches. At the end of methods
    * or functions with no return, Dart implicitly returns `null`, avoiding these
    * implicit returns is considered a best practice.
    *
-   * @param returnType the name of the declared return type
+   * Parameters:
+   * 0: the name of the declared return type
    */
   static const HintCode MISSING_RETURN = const HintCode('MISSING_RETURN',
       "This function declares a return type of '{0}', but does not end with a return statement",
       "Either add a return statement or change the return type to 'void'");
 
   /**
    * A getter with the override annotation does not override an existing getter.
    */
   static const HintCode OVERRIDE_ON_NON_OVERRIDING_GETTER = const HintCode(
       'OVERRIDE_ON_NON_OVERRIDING_GETTER',
       "Getter does not override an inherited getter");
 
   /**
    * A method with the override annotation does not override an existing method.
    */
   static const HintCode OVERRIDE_ON_NON_OVERRIDING_METHOD = const HintCode(
       'OVERRIDE_ON_NON_OVERRIDING_METHOD',
       "Method does not override an inherited method");
 
   /**
    * A setter with the override annotation does not override an existing setter.
    */
   static const HintCode OVERRIDE_ON_NON_OVERRIDING_SETTER = const HintCode(
       'OVERRIDE_ON_NON_OVERRIDING_SETTER',
       "Setter does not override an inherited setter");
 
   /**
    * Hint for classes that override equals, but not hashCode.
    *
-   * @param className the name of the current class
+   * Parameters:
+   * 0: the name of the current class
    */
   static const HintCode OVERRIDE_EQUALS_BUT_NOT_HASH_CODE = const HintCode(
       'OVERRIDE_EQUALS_BUT_NOT_HASH_CODE',
       "The class '{0}' overrides 'operator==', but not 'get hashCode'");
 
   /**
    * Type checks of the type `x is! Null` should be done with `x != null`.
    */
   static const HintCode TYPE_CHECK_IS_NOT_NULL = const HintCode(
       'TYPE_CHECK_IS_NOT_NULL',
       "Tests for non-null should be done with '!= null'");
 
   /**
    * Type checks of the type `x is Null` should be done with `x == null`.
    */
   static const HintCode TYPE_CHECK_IS_NULL = const HintCode(
       'TYPE_CHECK_IS_NULL', "Tests for null should be done with '== null'");
 
   /**
    * This hint is generated anywhere where the
    * [StaticTypeWarningCode.UNDEFINED_GETTER] or
    * [StaticWarningCode.UNDEFINED_GETTER] would have been generated, if we used
    * propagated information for the warnings.
    *
-   * @param getterName the name of the getter
-   * @param enclosingType the name of the enclosing type where the getter is
-   *        being looked for
+   * Parameters:
+   * 0: the name of the getter
+   * 1: the name of the enclosing type where the getter is being looked for
    */
   static const HintCode UNDEFINED_GETTER = const HintCode('UNDEFINED_GETTER',
       "The getter '{0}' is not defined for the class '{1}'");
 
   /**
    * This hint is generated anywhere where the
    * [StaticTypeWarningCode.UNDEFINED_METHOD] would have been generated, if we
    * used propagated information for the warnings.
    *
-   * @param methodName the name of the method that is undefined
-   * @param typeName the resolved type name that the method lookup is happening
-   *        on
+   * Parameters:
+   * 0: the name of the method that is undefined
+   * 1: the resolved type name that the method lookup is happening on
    */
   static const HintCode UNDEFINED_METHOD = const HintCode('UNDEFINED_METHOD',
       "The method '{0}' is not defined for the class '{1}'");
 
   /**
    * This hint is generated anywhere where the
    * [StaticTypeWarningCode.UNDEFINED_OPERATOR] would have been generated, if we
    * used propagated information for the warnings.
    *
-   * @param operator the name of the operator
-   * @param enclosingType the name of the enclosing type where the operator is
-   *        being looked for
+   * Parameters:
+   * 0: the name of the operator
+   * 1: the name of the enclosing type where the operator is being looked for
    */
   static const HintCode UNDEFINED_OPERATOR = const HintCode(
       'UNDEFINED_OPERATOR',
       "The operator '{0}' is not defined for the class '{1}'");
 
   /**
    * This hint is generated anywhere where the
    * [StaticTypeWarningCode.UNDEFINED_SETTER] or
    * [StaticWarningCode.UNDEFINED_SETTER] would have been generated, if we used
    * propagated information for the warnings.
    *
-   * @param setterName the name of the setter
-   * @param enclosingType the name of the enclosing type where the setter is
-   *        being looked for
+   * Parameters:
+   * 0: the name of the setter
+   * 1: the name of the enclosing type where the setter is being looked for
    */
   static const HintCode UNDEFINED_SETTER = const HintCode('UNDEFINED_SETTER',
       "The setter '{0}' is not defined for the class '{1}'");
 
   /**
    * Unnecessary cast.
    */
   static const HintCode UNNECESSARY_CAST =
       const HintCode('UNNECESSARY_CAST', "Unnecessary cast");
 
@@ skipping 33 matching lines @@
    * Unused local variables are local varaibles which are never read.
    */
   static const HintCode UNUSED_LOCAL_VARIABLE = const HintCode(
       'UNUSED_LOCAL_VARIABLE',
       "The value of the local variable '{0}' is not used");
 
   /**
    * Hint for cases where the source expects a method or function to return a
    * non-void result, but the method or function signature returns void.
    *
-   * @param name the name of the method or function that returns void
+   * Parameters:
+   * 0: the name of the method or function that returns void
    */
   static const HintCode USE_OF_VOID_RESULT = const HintCode(
       'USE_OF_VOID_RESULT',
       "The result of '{0}' is being used, even though it is declared to be 'void'");
 
   /**
    * It is a bad practice for a source file in a package "lib" directory
    * hierarchy to traverse outside that directory hierarchy. For example, a
    * source file in the "lib" directory should not contain a directive such as
    * `import '../web/some.dart'` which references a file outside the lib
@@ skipping 34 matching lines @@
       : super(name, message, correction);
 
   @override
   ErrorSeverity get errorSeverity => ErrorType.HINT.severity;
 
   @override
   ErrorType get type => ErrorType.HINT;
 }
 
 /**
- * The enumeration `HtmlWarningCode` defines the error codes used for warnings
- * in HTML files. The convention for this class is for the name of the error
- * code to indicate the problem that caused the error to be generated and for
- * the error message to explain what is wrong and, when appropriate, how the
- * problem can be corrected.
+ * The error codes used for warnings in HTML files. The convention for this
+ * class is for the name of the error code to indicate the problem that caused
+ * the error to be generated and for the error message to explain what is wrong
+ * and, when appropriate, how the problem can be corrected.
  */
 class HtmlWarningCode extends ErrorCode {
   /**
    * An error code indicating that the value of the 'src' attribute of a Dart
    * script tag is not a valid URI.
    *
-   * @param uri the URI that is invalid
+   * Parameters:
+   * 0: the URI that is invalid
    */
   static const HtmlWarningCode INVALID_URI =
       const HtmlWarningCode('INVALID_URI', "Invalid URI syntax: '{0}'");
 
   /**
    * An error code indicating that the value of the 'src' attribute of a Dart
    * script tag references a file that does not exist.
    *
-   * @param uri the URI pointing to a non-existent file
+   * Parameters:
+   * 0: the URI pointing to a non-existent file
    */
   static const HtmlWarningCode URI_DOES_NOT_EXIST = const HtmlWarningCode(
       'URI_DOES_NOT_EXIST', "Target of URI does not exist: '{0}'");
 
   /**
    * Initialize a newly created error code to have the given [name]. The message
    * associated with the error will be created from the given [message]
    * template. The correction associated with the error will be created from the
    * given [correction] template.
    */
   const HtmlWarningCode(String name, String message, [String correction])
       : super(name, message, correction);
 
   @override
   ErrorSeverity get errorSeverity => ErrorSeverity.WARNING;
 
   @override
   ErrorType get type => ErrorType.STATIC_WARNING;
 }
 
 /**
  * Defines style and best practice recommendations.
  *
- * Unlike [HintCode]s, which are akin to traditional static warnings from a compiler, lint recommendations focus on
- * matters of style and practices that might aggregated to define a project's style guide.
+ * Unlike [HintCode]s, which are akin to traditional static warnings from a
+ * compiler, lint recommendations focus on matters of style and practices that
+ * might aggregated to define a project's style guide.
  */
 class LintCode extends ErrorCode {
   const LintCode(String name, String message, [String correction])
       : super(name, message, correction);
 
   @override
   ErrorSeverity get errorSeverity => ErrorSeverity.INFO;
 
   @override
   ErrorType get type => ErrorType.LINT;
 }
 
 /**
- * The class `StaticTypeWarningCode` defines the error codes used for static
- * type warnings. The convention for this class is for the name of the error
- * code to indicate the problem that caused the error to be generated and for
- * the error message to explain what is wrong and, when appropriate, how the
- * problem can be corrected.
+ * The error codes used for static type warnings. The convention for this class
+ * is for the name of the error code to indicate the problem that caused the
+ * error to be generated and for the error message to explain what is wrong and,
+ * when appropriate, how the problem can be corrected.
  */
 class StaticTypeWarningCode extends ErrorCode {
   /**
    * 12.7 Lists: A fresh instance (7.6.1) <i>a</i>, of size <i>n</i>, whose
    * class implements the built-in class <i>List&lt;E></i> is allocated.
    *
-   * @param numTypeArgument the number of provided type arguments
+   * Parameters:
+   * 0: the number of provided type arguments
    */
   static const StaticTypeWarningCode EXPECTED_ONE_LIST_TYPE_ARGUMENTS =
       const StaticTypeWarningCode('EXPECTED_ONE_LIST_TYPE_ARGUMENTS',
           "List literal requires exactly one type arguments or none, but {0} found");
 
   /**
    * 12.8 Maps: A fresh instance (7.6.1) <i>m</i>, of size <i>n</i>, whose class
    * implements the built-in class <i>Map&lt;K, V></i> is allocated.
    *
-   * @param numTypeArgument the number of provided type arguments
+   * Parameters:
+   * 0: the number of provided type arguments
    */
   static const StaticTypeWarningCode EXPECTED_TWO_MAP_TYPE_ARGUMENTS =
       const StaticTypeWarningCode('EXPECTED_TWO_MAP_TYPE_ARGUMENTS',
           "Map literal requires exactly two type arguments or none, but {0} found");
 
   /**
    * 9 Functions: It is a static warning if the declared return type of a
    * function marked async* may not be assigned to Stream.
    */
   static const StaticTypeWarningCode ILLEGAL_ASYNC_GENERATOR_RETURN_TYPE =
@@ skipping 55 matching lines @@
    *   m<sub>k</sub></i> is inherited.
    */
   static const StaticTypeWarningCode INCONSISTENT_METHOD_INHERITANCE =
       const StaticTypeWarningCode('INCONSISTENT_METHOD_INHERITANCE',
           "'{0}' is inherited by at least two interfaces inconsistently, from {1}");
 
   /**
    * 12.15.1 Ordinary Invocation: It is a static type warning if <i>T</i> does
    * not have an accessible (3.2) instance member named <i>m</i>.
    *
-   * @param memberName the name of the static member
+   * Parameters:
+   * 0: the name of the static member
+   *
    * See [UNQUALIFIED_REFERENCE_TO_NON_LOCAL_STATIC_MEMBER].
    */
   static const StaticTypeWarningCode INSTANCE_ACCESS_TO_STATIC_MEMBER =
       const StaticTypeWarningCode('INSTANCE_ACCESS_TO_STATIC_MEMBER',
           "Static member '{0}' cannot be accessed using instance access");
 
   /**
    * 12.18 Assignment: It is a static type warning if the static type of
    * <i>e</i> may not be assigned to the static type of <i>v</i>. The static
    * type of the expression <i>v = e</i> is the static type of <i>e</i>.
    *
    * 12.18 Assignment: It is a static type warning if the static type of
    * <i>e</i> may not be assigned to the static type of <i>C.v</i>. The static
    * type of the expression <i>C.v = e</i> is the static type of <i>e</i>.
    *
    * 12.18 Assignment: Let <i>T</i> be the static type of <i>e<sub>1</sub></i>.
    * It is a static type warning if the static type of <i>e<sub>2</sub></i> may
    * not be assigned to <i>T</i>.
    *
-   * @param rhsTypeName the name of the right hand side type
-   * @param lhsTypeName the name of the left hand side type
+   * Parameters:
+   * 0: the name of the right hand side type
+   * 1: the name of the left hand side type
    */
   static const StaticTypeWarningCode INVALID_ASSIGNMENT =
       const StaticTypeWarningCode('INVALID_ASSIGNMENT',
           "A value of type '{0}' cannot be assigned to a variable of type '{1}'");
 
   /**
    * 12.15.1 Ordinary Invocation: An ordinary method invocation <i>i</i> has the
    * form <i>o.m(a<sub>1</sub>, &hellip;, a<sub>n</sub>, x<sub>n+1</sub>:
    * a<sub>n+1</sub>, &hellip; x<sub>n+k</sub>: a<sub>n+k</sub>)</i>.
    *
    * Let <i>T</i> be the static type of <i>o</i>. It is a static type warning if
    * <i>T</i> does not have an accessible instance member named <i>m</i>. If
    * <i>T.m</i> exists, it is a static warning if the type <i>F</i> of
    * <i>T.m</i> may not be assigned to a function type. If <i>T.m</i> does not
    * exist, or if <i>F</i> is not a function type, the static type of <i>i</i>
    * is dynamic.
    *
    * 12.15.3 Static Invocation: It is a static type warning if the type <i>F</i>
    * of <i>C.m</i> may not be assigned to a function type.
    *
    * 12.15.4 Super Invocation: A super method invocation <i>i</i> has the form
    * <i>super.m(a<sub>1</sub>, &hellip;, a<sub>n</sub>, x<sub>n+1</sub>:
    * a<sub>n+1</sub>, &hellip; x<sub>n+k</sub>: a<sub>n+k</sub>)</i>. If
    * <i>S.m</i> exists, it is a static warning if the type <i>F</i> of
    * <i>S.m</i> may not be assigned to a function type.
    *
-   * @param nonFunctionIdentifier the name of the identifier that is not a
-   *        function type
+   * Parameters:
+   * 0: the name of the identifier that is not a function type
    */
   static const StaticTypeWarningCode INVOCATION_OF_NON_FUNCTION =
       const StaticTypeWarningCode(
           'INVOCATION_OF_NON_FUNCTION', "'{0}' is not a method");
 
   /**
    * 12.14.4 Function Expression Invocation: A function expression invocation
    * <i>i</i> has the form <i>e<sub>f</sub>(a<sub>1</sub>, &hellip;,
    * a<sub>n</sub>, x<sub>n+1</sub>: a<sub>n+1</sub>, &hellip;, x<sub>n+k</sub>:
    * a<sub>n+k</sub>)</i>, where <i>e<sub>f</sub></i> is an expression.
@@ skipping 39 matching lines @@
    */
   static const StaticTypeWarningCode NON_BOOL_NEGATION_EXPRESSION =
       const StaticTypeWarningCode('NON_BOOL_NEGATION_EXPRESSION',
           "Negation argument must have a static type of 'bool'");
 
   /**
    * 12.21 Logical Boolean Expressions: It is a static type warning if the
    * static types of both of <i>e<sub>1</sub></i> and <i>e<sub>2</sub></i> may
    * not be assigned to bool.
    *
-   * @param operator the lexeme of the logical operator
+   * Parameters:
+   * 0: the lexeme of the logical operator
    */
   static const StaticTypeWarningCode NON_BOOL_OPERAND =
       const StaticTypeWarningCode('NON_BOOL_OPERAND',
           "The operands of the '{0}' operator must be assignable to 'bool'");
 
   /**
    * 15.8 Parameterized Types: It is a static type warning if <i>A<sub>i</sub>,
    * 1 &lt;= i &lt;= n</i> does not denote a type in the enclosing lexical scope.
    */
   static const StaticTypeWarningCode NON_TYPE_AS_TYPE_ARGUMENT =
       const StaticTypeWarningCode('NON_TYPE_AS_TYPE_ARGUMENT',
           "The name '{0}' is not a type and cannot be used as a parameterized type");
 
   /**
    * 13.11 Return: It is a static type warning if the type of <i>e</i> may not
    * be assigned to the declared return type of the immediately enclosing
    * function.
    *
-   * @param actualReturnType the return type as declared in the return statement
-   * @param expectedReturnType the expected return type as defined by the method
-   * @param methodName the name of the method
+   * Parameters:
+   * 0: the return type as declared in the return statement
+   * 1: the expected return type as defined by the method
+   * 2: the name of the method
    */
   static const StaticTypeWarningCode RETURN_OF_INVALID_TYPE =
       const StaticTypeWarningCode('RETURN_OF_INVALID_TYPE',
           "The return type '{0}' is not a '{1}', as defined by the method '{2}'");
 
   /**
    * 12.11 Instance Creation: It is a static type warning if any of the type
    * arguments to a constructor of a generic type <i>G</i> invoked by a new
    * expression or a constant object expression are not subtypes of the bounds
    * of the corresponding formal type parameters of <i>G</i>.
    *
    * 15.8 Parameterized Types: If <i>S</i> is the static type of a member
    * <i>m</i> of <i>G</i>, then the static type of the member <i>m</i> of
    * <i>G&lt;A<sub>1</sub>, &hellip;, A<sub>n</sub>&gt;</i> is <i>[A<sub>1</sub>,
    * &hellip;, A<sub>n</sub>/T<sub>1</sub>, &hellip;, T<sub>n</sub>]S</i> where
    * <i>T<sub>1</sub>, &hellip;, T<sub>n</sub></i> are the formal type
    * parameters of <i>G</i>. Let <i>B<sub>i</sub></i> be the bounds of
    * <i>T<sub>i</sub>, 1 &lt;= i &lt;= n</i>. It is a static type warning if
    * <i>A<sub>i</sub></i> is not a subtype of <i>[A<sub>1</sub>, &hellip;,
    * A<sub>n</sub>/T<sub>1</sub>, &hellip;, T<sub>n</sub>]B<sub>i</sub>, 1 &lt;=
    * i &lt;= n</i>.
    *
    * 7.6.2 Factories: It is a static type warning if any of the type arguments
    * to <i>k'</i> are not subtypes of the bounds of the corresponding formal
    * type parameters of type.
    *
-   * @param boundedTypeName the name of the type used in the instance creation
-   *        that should be limited by the bound as specified in the class
-   *        declaration
-   * @param boundingTypeName the name of the bounding type
+   * Parameters:
+   * 0: the name of the type used in the instance creation that should be
+   *    limited by the bound as specified in the class declaration
+   * 1: the name of the bounding type
+   *
    * See [TYPE_PARAMETER_SUPERTYPE_OF_ITS_BOUND].
    */
   static const StaticTypeWarningCode TYPE_ARGUMENT_NOT_MATCHING_BOUNDS =
       const StaticTypeWarningCode(
           'TYPE_ARGUMENT_NOT_MATCHING_BOUNDS', "'{0}' does not extend '{1}'");
 
   /**
    * 10 Generics: It is a static type warning if a type parameter is a supertype
    * of its upper bound.
    *
-   * @param typeParameterName the name of the type parameter
+   * Parameters:
+   * 0: the name of the type parameter
+   *
    * See [TYPE_ARGUMENT_NOT_MATCHING_BOUNDS].
    */
   static const StaticTypeWarningCode TYPE_PARAMETER_SUPERTYPE_OF_ITS_BOUND =
       const StaticTypeWarningCode('TYPE_PARAMETER_SUPERTYPE_OF_ITS_BOUND',
           "'{0}' cannot be a supertype of its upper bound");
 
   /**
    * 12.17 Getter Invocation: It is a static warning if there is no class
    * <i>C</i> in the enclosing lexical scope of <i>i</i>, or if <i>C</i> does
    * not declare, implicitly or explicitly, a getter named <i>m</i>.
    *
-   * @param constantName the name of the enumeration constant that is not
-   *        defined
-   * @param enumName the name of the enumeration used to access the constant
+   * Parameters:
+   * 0: the name of the enumeration constant that is not defined
+   * 1: the name of the enumeration used to access the constant
    */
   static const StaticTypeWarningCode UNDEFINED_ENUM_CONSTANT =
       const StaticTypeWarningCode('UNDEFINED_ENUM_CONSTANT',
           "There is no constant named '{0}' in '{1}'");
 
   /**
    * 12.15.3 Unqualified Invocation: If there exists a lexically visible
    * declaration named <i>id</i>, let <i>f<sub>id</sub></i> be the innermost
    * such declaration. Then: [skip]. Otherwise, <i>f<sub>id</sub></i> is
    * considered equivalent to the ordinary method invocation
    * <b>this</b>.<i>id</i>(<i>a<sub>1</sub></i>, ..., <i>a<sub>n</sub></i>,
    * <i>x<sub>n+1</sub></i> : <i>a<sub>n+1</sub></i>, ...,
    * <i>x<sub>n+k</sub></i> : <i>a<sub>n+k</sub></i>).
    *
-   * @param methodName the name of the method that is undefined
+   * Parameters:
+   * 0: the name of the method that is undefined
    */
   static const StaticTypeWarningCode UNDEFINED_FUNCTION =
       const StaticTypeWarningCode(
           'UNDEFINED_FUNCTION', "The function '{0}' is not defined");
 
   /**
    * 12.17 Getter Invocation: Let <i>T</i> be the static type of <i>e</i>. It is
    * a static type warning if <i>T</i> does not have a getter named <i>m</i>.
    *
-   * @param getterName the name of the getter
-   * @param enclosingType the name of the enclosing type where the getter is
-   *        being looked for
+   * Parameters:
+   * 0: the name of the getter
+   * 1: the name of the enclosing type where the getter is being looked for
    */
   static const StaticTypeWarningCode UNDEFINED_GETTER =
       const StaticTypeWarningCode('UNDEFINED_GETTER',
           "The getter '{0}' is not defined for the class '{1}'");
 
   /**
    * 12.15.1 Ordinary Invocation: Let <i>T</i> be the static type of <i>o</i>.
    * It is a static type warning if <i>T</i> does not have an accessible
    * instance member named <i>m</i>.
    *
-   * @param methodName the name of the method that is undefined
-   * @param typeName the resolved type name that the method lookup is happening
-   *        on
+   * Parameters:
+   * 0: the name of the method that is undefined
+   * 1: the resolved type name that the method lookup is happening on
    */
   static const StaticTypeWarningCode UNDEFINED_METHOD =
       const StaticTypeWarningCode('UNDEFINED_METHOD',
           "The method '{0}' is not defined for the class '{1}'");
 
   /**
    * 12.18 Assignment: Evaluation of an assignment of the form
    * <i>e<sub>1</sub></i>[<i>e<sub>2</sub></i>] = <i>e<sub>3</sub></i> is
    * equivalent to the evaluation of the expression (a, i, e){a.[]=(i, e);
    * return e;} (<i>e<sub>1</sub></i>, <i>e<sub>2</sub></i>,
    * <i>e<sub>2</sub></i>).
    *
    * 12.29 Assignable Expressions: An assignable expression of the form
    * <i>e<sub>1</sub></i>[<i>e<sub>2</sub></i>] is evaluated as a method
    * invocation of the operator method [] on <i>e<sub>1</sub></i> with argument
    * <i>e<sub>2</sub></i>.
    *
    * 12.15.1 Ordinary Invocation: Let <i>T</i> be the static type of <i>o</i>.
    * It is a static type warning if <i>T</i> does not have an accessible
    * instance member named <i>m</i>.
    *
-   * @param operator the name of the operator
-   * @param enclosingType the name of the enclosing type where the operator is
-   *        being looked for
+   * Parameters:
+   * 0: the name of the operator
+   * 1: the name of the enclosing type where the operator is being looked for
    */
   static const StaticTypeWarningCode UNDEFINED_OPERATOR =
       const StaticTypeWarningCode('UNDEFINED_OPERATOR',
           "The operator '{0}' is not defined for the class '{1}'");
 
   /**
    * 12.18 Assignment: Let <i>T</i> be the static type of <i>e<sub>1</sub></i>.
    * It is a static type warning if <i>T</i> does not have an accessible
    * instance setter named <i>v=</i>.
    *
-   * @param setterName the name of the setter
-   * @param enclosingType the name of the enclosing type where the setter is
-   *        being looked for
+   * Parameters:
+   * 0: the name of the setter
+   * 1: the name of the enclosing type where the setter is being looked for
+   *
    * See [INACCESSIBLE_SETTER].
    */
   static const StaticTypeWarningCode UNDEFINED_SETTER =
       const StaticTypeWarningCode('UNDEFINED_SETTER',
           "The setter '{0}' is not defined for the class '{1}'");
 
   /**
    * 12.17 Getter Invocation: Let <i>T</i> be the static type of <i>e</i>. It is
    * a static type warning if <i>T</i> does not have a getter named <i>m</i>.
    *
-   * @param getterName the name of the getter
-   * @param enclosingType the name of the enclosing type where the getter is
-   *        being looked for
+   * Parameters:
+   * 0: the name of the getter
+   * 1: the name of the enclosing type where the getter is being looked for
    */
   static const StaticTypeWarningCode UNDEFINED_SUPER_GETTER =
       const StaticTypeWarningCode('UNDEFINED_SUPER_GETTER',
           "The getter '{0}' is not defined in a superclass of '{1}'");
 
   /**
    * 12.15.4 Super Invocation: A super method invocation <i>i</i> has the form
    * <i>super.m(a<sub>1</sub>, &hellip;, a<sub>n</sub>, x<sub>n+1</sub>:
    * a<sub>n+1</sub>, &hellip; x<sub>n+k</sub>: a<sub>n+k</sub>)</i>. It is a
    * static type warning if <i>S</i> does not have an accessible instance member
    * named <i>m</i>.
    *
-   * @param methodName the name of the method that is undefined
-   * @param typeName the resolved type name that the method lookup is happening
-   *        on
+   * Parameters:
+   * 0: the name of the method that is undefined
+   * 1: the resolved type name that the method lookup is happening on
    */
   static const StaticTypeWarningCode UNDEFINED_SUPER_METHOD =
       const StaticTypeWarningCode('UNDEFINED_SUPER_METHOD',
           "The method '{0}' is not defined in a superclass of '{1}'");
 
   /**
    * 12.18 Assignment: Evaluation of an assignment of the form
    * <i>e<sub>1</sub></i>[<i>e<sub>2</sub></i>] = <i>e<sub>3</sub></i> is
    * equivalent to the evaluation of the expression (a, i, e){a.[]=(i, e);
    * return e;} (<i>e<sub>1</sub></i>, <i>e<sub>2</sub></i>,
    * <i>e<sub>2</sub></i>).
    *
    * 12.29 Assignable Expressions: An assignable expression of the form
    * <i>e<sub>1</sub></i>[<i>e<sub>2</sub></i>] is evaluated as a method
    * invocation of the operator method [] on <i>e<sub>1</sub></i> with argument
    * <i>e<sub>2</sub></i>.
    *
    * 12.15.1 Ordinary Invocation: Let <i>T</i> be the static type of <i>o</i>.
    * It is a static type warning if <i>T</i> does not have an accessible
    * instance member named <i>m</i>.
    *
-   * @param operator the name of the operator
-   * @param enclosingType the name of the enclosing type where the operator is
-   *        being looked for
+   * Parameters:
+   * 0: the name of the operator
+   * 1: the name of the enclosing type where the operator is being looked for
    */
   static const StaticTypeWarningCode UNDEFINED_SUPER_OPERATOR =
       const StaticTypeWarningCode('UNDEFINED_SUPER_OPERATOR',
           "The operator '{0}' is not defined in a superclass of '{1}'");
 
   /**
    * 12.18 Assignment: Let <i>T</i> be the static type of <i>e<sub>1</sub></i>.
    * It is a static type warning if <i>T</i> does not have an accessible
    * instance setter named <i>v=</i>.
    *
-   * @param setterName the name of the setter
-   * @param enclosingType the name of the enclosing type where the setter is
-   *        being looked for
+   * Parameters:
+   * 0: the name of the setter
+   * 1: the name of the enclosing type where the setter is being looked for
+   *
    * See [INACCESSIBLE_SETTER].
    */
   static const StaticTypeWarningCode UNDEFINED_SUPER_SETTER =
       const StaticTypeWarningCode('UNDEFINED_SUPER_SETTER',
           "The setter '{0}' is not defined in a superclass of '{1}'");
 
   /**
    * 12.15.1 Ordinary Invocation: It is a static type warning if <i>T</i> does
    * not have an accessible (3.2) instance member named <i>m</i>.
    *
    * This is a specialization of [INSTANCE_ACCESS_TO_STATIC_MEMBER] that is used
    * when we are able to find the name defined in a supertype. It exists to
    * provide a more informative error message.
    */
   static const StaticTypeWarningCode UNQUALIFIED_REFERENCE_TO_NON_LOCAL_STATIC_MEMBER =
       const StaticTypeWarningCode(
           'UNQUALIFIED_REFERENCE_TO_NON_LOCAL_STATIC_MEMBER',
           "Static members from supertypes must be qualified by the name of the defining type");
 
   /**
    * 15.8 Parameterized Types: It is a static type warning if <i>G</i> is not a
    * generic type with exactly <i>n</i> type parameters.
    *
-   * @param typeName the name of the type being referenced (<i>G</i>)
-   * @param parameterCount the number of type parameters that were declared
-   * @param argumentCount the number of type arguments provided
+   * Parameters:
+   * 0: the name of the type being referenced (<i>G</i>)
+   * 1: the number of type parameters that were declared
+   * 2: the number of type arguments provided
+   *
    * See [CompileTimeErrorCode.CONST_WITH_INVALID_TYPE_PARAMETERS], and
    * [CompileTimeErrorCode.NEW_WITH_INVALID_TYPE_PARAMETERS].
    */
   static const StaticTypeWarningCode WRONG_NUMBER_OF_TYPE_ARGUMENTS =
       const StaticTypeWarningCode('WRONG_NUMBER_OF_TYPE_ARGUMENTS',
           "The type '{0}' is declared with {1} type parameters, but {2} type arguments were given");
 
   /**
    * 17.16.1 Yield: Let T be the static type of e [the expression to the right
    * of "yield"] and let f be the immediately enclosing function.  It is a
@@ skipping 26 matching lines @@
       : super(name, message, correction);
 
   @override
   ErrorSeverity get errorSeverity => ErrorType.STATIC_TYPE_WARNING.severity;
 
   @override
   ErrorType get type => ErrorType.STATIC_TYPE_WARNING;
 }
 
 /**
- * The enumeration `StaticWarningCode` defines the error codes used for static
- * warnings. The convention for this class is for the name of the error code to
- * indicate the problem that caused the error to be generated and for the error
- * message to explain what is wrong and, when appropriate, how the problem can
- * be corrected.
+ * The error codes used for static warnings. The convention for this class is
+ * for the name of the error code to indicate the problem that caused the error
+ * to be generated and for the error message to explain what is wrong and, when
+ * appropriate, how the problem can be corrected.
  */
 class StaticWarningCode extends ErrorCode {
   /**
    * 14.1 Imports: If a name <i>N</i> is referenced by a library <i>L</i> and
    * <i>N</i> is introduced into the top level scope <i>L</i> by more than one
    * import then:
    * 1. A static warning occurs.
    * 2. If <i>N</i> is referenced as a function, getter or setter, a
    *    <i>NoSuchMethodError</i> is raised.
    * 3. If <i>N</i> is referenced as a type, it is treated as a malformed type.
    *
-   * @param ambiguousTypeName the name of the ambiguous type
-   * @param firstLibraryName the name of the first library that the type is
-   *        found
-   * @param secondLibraryName the name of the second library that the type is
-   *        found
+   * Parameters:
+   * 0: the name of the ambiguous type
+   * 1: the name of the first library that the type is found
+   * 2: the name of the second library that the type is found
    */
   static const StaticWarningCode AMBIGUOUS_IMPORT = const StaticWarningCode(
       'AMBIGUOUS_IMPORT', "The name '{0}' is defined in the libraries {1}",
       "Consider using 'as prefix' for one of the import directives "
       "or hiding the name from all but one of the imports.");
 
   /**
    * 12.11.1 New: It is a static warning if the static type of <i>a<sub>i</sub>,
    * 1 &lt;= i &lt;= n+ k</i> may not be assigned to the type of the
    * corresponding formal parameter of the constructor <i>T.id</i> (respectively
@@ skipping 11 matching lines @@
    * warning if <i>T<sub>j</sub></i> may not be assigned to <i>S<sub>j</sub>, 1
    * &lt;= j &lt;= m</i>.
    *
    * 12.14.2 Binding Actuals to Formals: Furthermore, each <i>q<sub>i</sub>, 1
    * &lt;= i &lt;= l</i>, must have a corresponding named parameter in the set
    * <i>{p<sub>n+1</sub>, &hellip; p<sub>n+k</sub>}</i> or a static warning
    * occurs. It is a static warning if <i>T<sub>m+j</sub></i> may not be
    * assigned to <i>S<sub>r</sub></i>, where <i>r = q<sub>j</sub>, 1 &lt;= j
    * &lt;= l</i>.
    *
-   * @param actualType the name of the actual argument type
-   * @param expectedType the name of the expected type
+   * Parameters:
+   * 0: the name of the actual argument type
+   * 1: the name of the expected type
    */
   static const StaticWarningCode ARGUMENT_TYPE_NOT_ASSIGNABLE =
       const StaticWarningCode('ARGUMENT_TYPE_NOT_ASSIGNABLE',
           "The argument type '{0}' cannot be assigned to the parameter type '{1}'");
 
   /**
    * 5 Variables: Attempting to assign to a final variable elsewhere will cause
    * a NoSuchMethodError to be thrown, because no setter is defined for it. The
    * assignment will also give rise to a static warning for the same reason.
    *
@@ skipping 64 matching lines @@
           "'{0}' must have a method body because '{1}' is not abstract");
 
   /**
    * 14.1 Imports: If a name <i>N</i> is referenced by a library <i>L</i> and
    * <i>N</i> would be introduced into the top level scope of <i>L</i> by an
    * import from a library whose URI begins with <i>dart:</i> and an import from
    * a library whose URI does not begin with <i>dart:</i>:
    * * The import from <i>dart:</i> is implicitly extended by a hide N clause.
    * * A static warning is issued.
    *
-   * @param ambiguousName the ambiguous name
-   * @param sdkLibraryName the name of the dart: library that the element is
-   *        found
-   * @param otherLibraryName the name of the non-dart: library that the element
-   *        is found
+   * Parameters:
+   * 0: the ambiguous name
+   * 1: the name of the dart: library in which the element is found
+   * 1: the name of the non-dart: library in which the element is found
    */
   static const StaticWarningCode CONFLICTING_DART_IMPORT =
       const StaticWarningCode('CONFLICTING_DART_IMPORT',
           "Element '{0}' from SDK library '{1}' is implicitly hidden by '{2}'");
 
   /**
    * 7.2 Getters: It is a static warning if a class <i>C</i> declares an
    * instance getter named <i>v</i> and an accessible static member named
    * <i>v</i> or <i>v=</i> is declared in a superclass of <i>C</i>.
    *
-   * @param superName the name of the super class declaring a static member
+   * Parameters:
+   * 0: the name of the super class declaring a static member
    */
   static const StaticWarningCode CONFLICTING_INSTANCE_GETTER_AND_SUPERCLASS_MEMBER =
       const StaticWarningCode(
           'CONFLICTING_INSTANCE_GETTER_AND_SUPERCLASS_MEMBER',
           "Superclass '{0}' declares static member with the same name");
 
   /**
    * 7.1 Instance Methods: It is a static warning if a class <i>C</i> declares
    * an instance method named <i>n</i> and has a setter named <i>n=</i>.
    */
   static const StaticWarningCode CONFLICTING_INSTANCE_METHOD_SETTER =
       const StaticWarningCode('CONFLICTING_INSTANCE_METHOD_SETTER',
           "Class '{0}' declares instance method '{1}', but also has a setter with the same name from '{2}'");
 
   /**
    * 7.1 Instance Methods: It is a static warning if a class <i>C</i> declares
    * an instance method named <i>n</i> and has a setter named <i>n=</i>.
    */
   static const StaticWarningCode CONFLICTING_INSTANCE_METHOD_SETTER2 =
       const StaticWarningCode('CONFLICTING_INSTANCE_METHOD_SETTER2',
           "Class '{0}' declares the setter '{1}', but also has an instance method in the same class");
 
   /**
    * 7.3 Setters: It is a static warning if a class <i>C</i> declares an
    * instance setter named <i>v=</i> and an accessible static member named
    * <i>v=</i> or <i>v</i> is declared in a superclass of <i>C</i>.
    *
-   * @param superName the name of the super class declaring a static member
+   * Parameters:
+   * 0: the name of the super class declaring a static member
    */
   static const StaticWarningCode CONFLICTING_INSTANCE_SETTER_AND_SUPERCLASS_MEMBER =
       const StaticWarningCode(
           'CONFLICTING_INSTANCE_SETTER_AND_SUPERCLASS_MEMBER',
           "Superclass '{0}' declares static member with the same name");
 
   /**
    * 7.2 Getters: It is a static warning if a class declares a static getter
    * named <i>v</i> and also has a non-static setter named <i>v=</i>.
    */
@@ skipping 23 matching lines @@
    * 12.7 Maps: It is a static warning if the values of any two keys in a map
    * literal are equal.
    */
   static const StaticWarningCode EQUAL_KEYS_IN_MAP = const StaticWarningCode(
       'EQUAL_KEYS_IN_MAP', "Keys in a map cannot be equal");
 
   /**
    * 14.2 Exports: It is a static warning to export two different libraries with
    * the same name.
    *
-   * @param uri1 the uri pointing to a first library
-   * @param uri2 the uri pointing to a second library
-   * @param name the shared name of the exported libraries
+   * Parameters:
+   * 0: the uri pointing to a first library
+   * 1: the uri pointing to a second library
+   * 2:e the shared name of the exported libraries
    */
   static const StaticWarningCode EXPORT_DUPLICATED_LIBRARY_NAMED =
       const StaticWarningCode('EXPORT_DUPLICATED_LIBRARY_NAMED',
           "The exported libraries '{0}' and '{1}' cannot have the same name '{2}'");
 
   /**
    * 14.2 Exports: It is a static warning to export two different libraries with
    * the same name.
    *
-   * @param uri1 the uri pointing to a first library
-   * @param uri2 the uri pointing to a second library
+   * Parameters:
+   * 0: the uri pointing to a first library
+   * 1: the uri pointing to a second library
    */
   static const StaticWarningCode EXPORT_DUPLICATED_LIBRARY_UNNAMED =
       const StaticWarningCode('EXPORT_DUPLICATED_LIBRARY_UNNAMED',
           "The exported libraries '{0}' and '{1}' cannot both be unnamed");
 
   /**
    * 12.14.2 Binding Actuals to Formals: It is a static warning if <i>m &lt;
    * h</i> or if <i>m &gt; n</i>.
    *
-   * @param requiredCount the maximum number of positional arguments
-   * @param argumentCount the actual number of positional arguments given
+   * Parameters:
+   * 0: the maximum number of positional arguments
+   * 1: the actual number of positional arguments given
+   *
    * See [NOT_ENOUGH_REQUIRED_ARGUMENTS].
    */
   static const StaticWarningCode EXTRA_POSITIONAL_ARGUMENTS =
       const StaticWarningCode('EXTRA_POSITIONAL_ARGUMENTS',
           "{0} positional arguments expected, but {1} found");
 
   /**
    * 5. Variables: It is a static warning if a final instance variable that has
    * been initialized at its point of declaration is also initialized in a
    * constructor.
    */
   static const StaticWarningCode FIELD_INITIALIZED_IN_INITIALIZER_AND_DECLARATION =
       const StaticWarningCode(
           'FIELD_INITIALIZED_IN_INITIALIZER_AND_DECLARATION',
           "Values cannot be set in the constructor if they are final, and have already been set");
 
   /**
    * 5. Variables: It is a static warning if a final instance variable that has
    * been initialized at its point of declaration is also initialized in a
    * constructor.
    *
-   * @param name the name of the field in question
+   * Parameters:
+   * 0: the name of the field in question
    */
   static const StaticWarningCode FINAL_INITIALIZED_IN_DECLARATION_AND_CONSTRUCTOR =
       const StaticWarningCode(
           'FINAL_INITIALIZED_IN_DECLARATION_AND_CONSTRUCTOR',
           "'{0}' is final and was given a value when it was declared, so it cannot be set to a new value");
 
   /**
    * 7.6.1 Generative Constructors: Execution of an initializer of the form
    * <b>this</b>.<i>v</i> = <i>e</i> proceeds as follows: First, the expression
    * <i>e</i> is evaluated to an object <i>o</i>. Then, the instance variable
    * <i>v</i> of the object denoted by this is bound to <i>o</i>.
    *
    * 12.14.2 Binding Actuals to Formals: Let <i>T<sub>i</sub></i> be the static
    * type of <i>a<sub>i</sub></i>, let <i>S<sub>i</sub></i> be the type of
    * <i>p<sub>i</sub>, 1 &lt;= i &lt;= n+k</i> and let <i>S<sub>q</sub></i> be
    * the type of the named parameter <i>q</i> of <i>f</i>. It is a static
    * warning if <i>T<sub>j</sub></i> may not be assigned to <i>S<sub>j</sub>, 1
    * &lt;= j &lt;= m</i>.
    *
-   * @param initializerType the name of the type of the initializer expression
-   * @param fieldType the name of the type of the field
+   * Parameters:
+   * 0: the name of the type of the initializer expression
+   * 1: the name of the type of the field
    */
   static const StaticWarningCode FIELD_INITIALIZER_NOT_ASSIGNABLE =
       const StaticWarningCode('FIELD_INITIALIZER_NOT_ASSIGNABLE',
           "The initializer type '{0}' cannot be assigned to the field type '{1}'");
 
   /**
    * 7.6.1 Generative Constructors: An initializing formal has the form
    * <i>this.id</i>. It is a static warning if the static type of <i>id</i> is
    * not assignable to <i>T<sub>id</sub></i>.
    *
-   * @param parameterType the name of the type of the field formal parameter
-   * @param fieldType the name of the type of the field
+   * Parameters:
+   * 0: the name of the type of the field formal parameter
+   * 1: the name of the type of the field
    */
   static const StaticWarningCode FIELD_INITIALIZING_FORMAL_NOT_ASSIGNABLE =
       const StaticWarningCode('FIELD_INITIALIZING_FORMAL_NOT_ASSIGNABLE',
           "The parameter type '{0}' is incompatable with the field type '{1}'");
 
   /**
    * 5 Variables: It is a static warning if a library, static or local variable
    * <i>v</i> is final and <i>v</i> is not initialized at its point of
    * declaration.
    *
    * 7.6.1 Generative Constructors: Each final instance variable <i>f</i>
    * declared in the immediately enclosing class must have an initializer in
    * <i>k</i>'s initializer list unless it has already been initialized by one
    * of the following means:
    * * Initialization at the declaration of <i>f</i>.
    * * Initialization by means of an initializing formal of <i>k</i>.
    * or a static warning occurs.
    *
-   * @param name the name of the uninitialized final variable
+   * Parameters:
+   * 0: the name of the uninitialized final variable
    */
   static const StaticWarningCode FINAL_NOT_INITIALIZED =
       const StaticWarningCode('FINAL_NOT_INITIALIZED',
           "The final variable '{0}' must be initialized");
 
   /**
    * 15.5 Function Types: It is a static warning if a concrete class implements
    * Function and does not have a concrete method named call().
    */
   static const StaticWarningCode FUNCTION_WITHOUT_CALL = const StaticWarningCode(
       'FUNCTION_WITHOUT_CALL',
       "Concrete classes that implement Function must implement the method call()");
 
   /**
    * 14.1 Imports: It is a static warning to import two different libraries with
    * the same name.
    *
-   * @param uri1 the uri pointing to a first library
-   * @param uri2 the uri pointing to a second library
-   * @param name the shared name of the imported libraries
+   * Parameters:
+   * 0: the uri pointing to a first library
+   * 1: the uri pointing to a second library
+   * 2: the shared name of the imported libraries
    */
   static const StaticWarningCode IMPORT_DUPLICATED_LIBRARY_NAMED =
       const StaticWarningCode('IMPORT_DUPLICATED_LIBRARY_NAMED',
           "The imported libraries '{0}' and '{1}' cannot have the same name '{2}'");
 
   /**
    * 14.1 Imports: It is a static warning to import two different libraries with
    * the same name.
    *
-   * @param uri1 the uri pointing to a first library
-   * @param uri2 the uri pointing to a second library
+   * Parameters:
+   * 0: the uri pointing to a first library
+   * 1: the uri pointing to a second library
    */
   static const StaticWarningCode IMPORT_DUPLICATED_LIBRARY_UNNAMED =
       const StaticWarningCode('IMPORT_DUPLICATED_LIBRARY_UNNAMED',
           "The imported libraries '{0}' and '{1}' cannot both be unnamed");
 
   /**
    * 14.1 Imports: It is a static warning if the specified URI of a deferred
    * import does not refer to a library declaration.
    *
-   * @param uri the uri pointing to a non-library declaration
+   * Parameters:
+   * 0: the uri pointing to a non-library declaration
+   *
    * See [CompileTimeErrorCode.IMPORT_OF_NON_LIBRARY].
    */
   static const StaticWarningCode IMPORT_OF_NON_LIBRARY =
       const StaticWarningCode('IMPORT_OF_NON_LIBRARY',
           "The imported library '{0}' must not have a part-of directive");
 
   /**
    * 8.1.1 Inheritance and Overriding: However, if the above rules would cause
    * multiple members <i>m<sub>1</sub>, &hellip;, m<sub>k</sub></i> with the
    * same name <i>n</i> that would be inherited (because identically named
    * members existed in several superinterfaces) then at most one member is
    * inherited.
    *
    * If some but not all of the <i>m<sub>i</sub>, 1 &lt;= i &lt;= k</i> are
    * getters none of the <i>m<sub>i</sub></i> are inherited, and a static
    * warning is issued.
    */
   static const StaticWarningCode INCONSISTENT_METHOD_INHERITANCE_GETTER_AND_METHOD =
       const StaticWarningCode(
           'INCONSISTENT_METHOD_INHERITANCE_GETTER_AND_METHOD',
           "'{0}' is inherited as a getter and also a method");
 
   /**
    * 7.1 Instance Methods: It is a static warning if a class <i>C</i> declares
    * an instance method named <i>n</i> and an accessible static member named
    * <i>n</i> is declared in a superclass of <i>C</i>.
    *
-   * @param memberName the name of the member with the name conflict
-   * @param superclassName the name of the enclosing class that has the static
-   *        member
+   * Parameters:
+   * 0: the name of the member with the name conflict
+   * 1: the name of the enclosing class that has the static member
    */
   static const StaticWarningCode INSTANCE_METHOD_NAME_COLLIDES_WITH_SUPERCLASS_STATIC =
       const StaticWarningCode(
           'INSTANCE_METHOD_NAME_COLLIDES_WITH_SUPERCLASS_STATIC',
           "'{0}' collides with a static member in the superclass '{1}'");
 
   /**
    * 7.2 Getters: It is a static warning if a getter <i>m1</i> overrides a
    * getter <i>m2</i> and the type of <i>m1</i> is not a subtype of the type of
    * <i>m2</i>.
    *
-   * @param actualReturnTypeName the name of the expected return type
-   * @param expectedReturnType the name of the actual return type, not
-   *        assignable to the actualReturnTypeName
-   * @param className the name of the class where the overridden getter is
-   *        declared
+   * Parameters:
+   * 0: the name of the actual return type
+   * 1: the name of the expected return type, not assignable to the actual
+   *    return type
+   * 2: the name of the class where the overridden getter is declared
+   *
    * See [INVALID_METHOD_OVERRIDE_RETURN_TYPE].
    */
   static const StaticWarningCode INVALID_GETTER_OVERRIDE_RETURN_TYPE =
       const StaticWarningCode('INVALID_GETTER_OVERRIDE_RETURN_TYPE',
           "The return type '{0}' is not assignable to '{1}' as required by the getter it is overriding from '{2}'");
 
   /**
    * 7.1 Instance Methods: It is a static warning if an instance method
    * <i>m1</i> overrides an instance method <i>m2</i> and the type of <i>m1</i>
    * is not a subtype of the type of <i>m2</i>.
    *
-   * @param actualParamTypeName the name of the expected parameter type
-   * @param expectedParamType the name of the actual parameter type, not
-   *        assignable to the actualParamTypeName
-   * @param className the name of the class where the overridden method is
-   *        declared
+   * Parameters:
+   * 0: the name of the actual parameter type
+   * 1: the name of the expected parameter type, not assignable to the actual
+   *    parameter type
+   * 2: the name of the class where the overridden method is declared
    */
   static const StaticWarningCode INVALID_METHOD_OVERRIDE_NAMED_PARAM_TYPE =
       const StaticWarningCode('INVALID_METHOD_OVERRIDE_NAMED_PARAM_TYPE',
           "The parameter type '{0}' is not assignable to '{1}' as required by the method it is overriding from '{2}'");
 
   /**
    * 7.1 Instance Methods: It is a static warning if an instance method
    * <i>m1</i> overrides an instance method <i>m2</i> and the type of <i>m1</i>
    * is not a subtype of the type of <i>m2</i>.
    *
-   * @param actualParamTypeName the name of the expected parameter type
-   * @param expectedParamType the name of the actual parameter type, not
-   *        assignable to the actualParamTypeName
-   * @param className the name of the class where the overridden method is
-   *        declared
+   * Parameters:
+   * 0: the name of the actual parameter type
+   * 1: the name of the expected parameter type, not assignable to the actual
+   *    parameter type
+   * 2: the name of the class where the overridden method is declared
    * See [INVALID_SETTER_OVERRIDE_NORMAL_PARAM_TYPE].
    */
   static const StaticWarningCode INVALID_METHOD_OVERRIDE_NORMAL_PARAM_TYPE =
       const StaticWarningCode('INVALID_METHOD_OVERRIDE_NORMAL_PARAM_TYPE',
           "The parameter type '{0}' is not assignable to '{1}' as required by the method it is overriding from '{2}'");
 
   /**
    * 7.1 Instance Methods: It is a static warning if an instance method
    * <i>m1</i> overrides an instance method <i>m2</i> and the type of <i>m1</i>
    * is not a subtype of the type of <i>m2</i>.
    *
-   * @param actualParamTypeName the name of the expected parameter type
-   * @param expectedParamType the name of the actual parameter type, not
-   *        assignable to the actualParamTypeName
-   * @param className the name of the class where the overridden method is
-   *        declared
+   * Parameters:
+   * 0: the name of the actual parameter type
+   * 1: the name of the expected parameter type, not assignable to the actual
+   *    parameter type
+   * 2: the name of the class where the overridden method is declared
    */
   static const StaticWarningCode INVALID_METHOD_OVERRIDE_OPTIONAL_PARAM_TYPE =
       const StaticWarningCode('INVALID_METHOD_OVERRIDE_OPTIONAL_PARAM_TYPE',
           "The parameter type '{0}' is not assignable to '{1}' as required by the method it is overriding from '{2}'");
 
   /**
    * 7.1 Instance Methods: It is a static warning if an instance method
    * <i>m1</i> overrides an instance method <i>m2</i> and the type of <i>m1</i>
    * is not a subtype of the type of <i>m2</i>.
    *
-   * @param actualReturnTypeName the name of the expected return type
-   * @param expectedReturnType the name of the actual return type, not
-   *        assignable to the actualReturnTypeName
-   * @param className the name of the class where the overridden method is
-   *        declared
+   * Parameters:
+   * 0: the name of the actual return type
+   * 1: the name of the expected return type, not assignable to the actual
+   *    return type
+   * 2: the name of the class where the overridden method is declared
+   *
    * See [INVALID_GETTER_OVERRIDE_RETURN_TYPE].
    */
   static const StaticWarningCode INVALID_METHOD_OVERRIDE_RETURN_TYPE =
       const StaticWarningCode('INVALID_METHOD_OVERRIDE_RETURN_TYPE',
           "The return type '{0}' is not assignable to '{1}' as required by the method it is overriding from '{2}'");
 
   /**
    * 7.1 Instance Methods: It is a static warning if an instance method
    * <i>m1</i> overrides an instance member <i>m2</i>, the signature of
    * <i>m2</i> explicitly specifies a default value for a formal parameter
@@ skipping 14 matching lines @@
   static const StaticWarningCode INVALID_OVERRIDE_DIFFERENT_DEFAULT_VALUES_POSITIONAL =
       const StaticWarningCode(
           'INVALID_OVERRIDE_DIFFERENT_DEFAULT_VALUES_POSITIONAL',
           "Parameters cannot override default values, this method overrides '{0}.{1}' where this positional parameter has a different value");
 
   /**
    * 7.1 Instance Methods: It is a static warning if an instance method
    * <i>m1</i> overrides an instance member <i>m2</i> and <i>m1</i> does not
    * declare all the named parameters declared by <i>m2</i>.
    *
-   * @param paramCount the number of named parameters in the overridden member
-   * @param className the name of the class from the overridden method
+   * Parameters:
+   * 0: the number of named parameters in the overridden member
+   * 1: the name of the class from the overridden method
    */
   static const StaticWarningCode INVALID_OVERRIDE_NAMED = const StaticWarningCode(
       'INVALID_OVERRIDE_NAMED',
       "Missing the named parameter '{0}' to match the overridden method from '{1}'");
 
   /**
    * 7.1 Instance Methods: It is a static warning if an instance method
    * <i>m1</i> overrides an instance member <i>m2</i> and <i>m1</i> has fewer
    * positional parameters than <i>m2</i>.
    *
-   * @param paramCount the number of positional parameters in the overridden
-   *        member
-   * @param className the name of the class from the overridden method
+   * Parameters:
+   * 0: the number of positional parameters in the overridden member
+   * 1: the name of the class from the overridden method
    */
   static const StaticWarningCode INVALID_OVERRIDE_POSITIONAL =
       const StaticWarningCode('INVALID_OVERRIDE_POSITIONAL',
           "Must have at least {0} parameters to match the overridden method from '{1}'");
 
   /**
    * 7.1 Instance Methods: It is a static warning if an instance method
    * <i>m1</i> overrides an instance member <i>m2</i> and <i>m1</i> has a
    * greater number of required parameters than <i>m2</i>.
    *
-   * @param paramCount the number of required parameters in the overridden
-   *        member
-   * @param className the name of the class from the overridden method
+   * Parameters:
+   * 0: the number of required parameters in the overridden member
+   * 1: the name of the class from the overridden method
    */
   static const StaticWarningCode INVALID_OVERRIDE_REQUIRED =
       const StaticWarningCode('INVALID_OVERRIDE_REQUIRED',
           "Must have {0} required parameters or less to match the overridden method from '{1}'");
 
   /**
    * 7.3 Setters: It is a static warning if a setter <i>m1</i> overrides a
    * setter <i>m2</i> and the type of <i>m1</i> is not a subtype of the type of
    * <i>m2</i>.
    *
-   * @param actualParamTypeName the name of the expected parameter type
-   * @param expectedParamType the name of the actual parameter type, not
-   *        assignable to the actualParamTypeName
-   * @param className the name of the class where the overridden setter is
-   *        declared
+   * Parameters:
+   * 0: the name of the actual parameter type
+   * 1: the name of the expected parameter type, not assignable to the actual
+   * parameter type
+   * 2: the name of the class where the overridden setter is declared
+   *
    * See [INVALID_METHOD_OVERRIDE_NORMAL_PARAM_TYPE].
    */
   static const StaticWarningCode INVALID_SETTER_OVERRIDE_NORMAL_PARAM_TYPE =
       const StaticWarningCode('INVALID_SETTER_OVERRIDE_NORMAL_PARAM_TYPE',
           "The parameter type '{0}' is not assignable to '{1}' as required by the setter it is overriding from '{2}'");
 
   /**
    * 12.6 Lists: A run-time list literal &lt;<i>E</i>&gt; [<i>e<sub>1</sub></i>
    * &hellip; <i>e<sub>n</sub></i>] is evaluated as follows:
    * * The operator []= is invoked on <i>a</i> with first argument <i>i</i> and
@@ skipping 81 matching lines @@
    * abstract class and <i>q</i> is not a factory constructor.
    */
   static const StaticWarningCode NEW_WITH_ABSTRACT_CLASS =
       const StaticWarningCode('NEW_WITH_ABSTRACT_CLASS',
           "Abstract classes cannot be created with a 'new' expression");
 
   /**
    * 15.8 Parameterized Types: Any use of a malbounded type gives rise to a
    * static warning.
    *
-   * @param typeName the name of the type being referenced (<i>S</i>)
-   * @param parameterCount the number of type parameters that were declared
-   * @param argumentCount the number of type arguments provided
+   * Parameters:
+   * 0: the name of the type being referenced (<i>S</i>)
+   * 1: the number of type parameters that were declared
+   * 2: the number of type arguments provided
+   *
    * See [CompileTimeErrorCode.CONST_WITH_INVALID_TYPE_PARAMETERS], and
    * [StaticTypeWarningCode.WRONG_NUMBER_OF_TYPE_ARGUMENTS].
    */
   static const StaticWarningCode NEW_WITH_INVALID_TYPE_PARAMETERS =
       const StaticWarningCode('NEW_WITH_INVALID_TYPE_PARAMETERS',
           "The type '{0}' is declared with {1} type parameters, but {2} type arguments were given");
 
   /**
    * 12.11.1 New: It is a static warning if <i>T</i> is not a class accessible
    * in the current scope, optionally followed by type arguments.
    *
-   * @param name the name of the non-type element
+   * Parameters:
+   * 0: the name of the non-type element
    */
   static const StaticWarningCode NEW_WITH_NON_TYPE = const StaticWarningCode(
       'NEW_WITH_NON_TYPE', "The name '{0}' is not a class");
 
   /**
    * 12.11.1 New: If <i>T</i> is a class or parameterized type accessible in the
    * current scope then:
    * 1. If <i>e</i> is of the form <i>new T.id(a<sub>1</sub>, &hellip;,
    *    a<sub>n</sub>, x<sub>n+1</sub>: a<sub>n+1</sub>, &hellip;,
    *    x<sub>n+k</sub>: a<sub>n+k</sub>)</i> it is a static warning if
@@ skipping 31 matching lines @@
    * 7.10 Superinterfaces: Let <i>C</i> be a concrete class that does not
    * declare its own <i>noSuchMethod()</i> method. It is a static warning if the
    * implicit interface of <i>C</i> includes an instance member <i>m</i> of type
    * <i>F</i> and <i>C</i> does not declare or inherit a corresponding instance
    * member <i>m</i> of type <i>F'</i> such that <i>F' <: F</i>.
    *
    * 7.4 Abstract Instance Members: It is a static warning if an abstract member
    * is declared or inherited in a concrete class unless that member overrides a
    * concrete one.
    *
-   * @param memberName the name of the first member
-   * @param memberName the name of the second member
-   * @param memberName the name of the third member
-   * @param memberName the name of the fourth member
-   * @param additionalCount the number of additional missing members that aren't
-   *        listed
+   * Parameters:
+   * 0: the name of the first member
+   * 1: the name of the second member
+   * 2: the name of the third member
+   * 3: the name of the fourth member
+   * 4: the number of additional missing members that aren't listed
    */
   static const StaticWarningCode NON_ABSTRACT_CLASS_INHERITS_ABSTRACT_MEMBER_FIVE_PLUS =
       const StaticWarningCode(
           'NON_ABSTRACT_CLASS_INHERITS_ABSTRACT_MEMBER_FIVE_PLUS',
           "Missing concrete implementation of {0}, {1}, {2}, {3} and {4} more");
 
   /**
    * 7.9.1 Inheritance and Overriding: It is a static warning if a non-abstract
    * class inherits an abstract method.
    *
    * 7.10 Superinterfaces: Let <i>C</i> be a concrete class that does not
    * declare its own <i>noSuchMethod()</i> method. It is a static warning if the
    * implicit interface of <i>C</i> includes an instance member <i>m</i> of type
    * <i>F</i> and <i>C</i> does not declare or inherit a corresponding instance
    * member <i>m</i> of type <i>F'</i> such that <i>F' <: F</i>.
    *
    * 7.4 Abstract Instance Members: It is a static warning if an abstract member
    * is declared or inherited in a concrete class unless that member overrides a
    * concrete one.
    *
-   * @param memberName the name of the first member
-   * @param memberName the name of the second member
-   * @param memberName the name of the third member
-   * @param memberName the name of the fourth member
+   * Parameters:
+   * 0: the name of the first member
+   * 1: the name of the second member
+   * 2: the name of the third member
+   * 3: the name of the fourth member
    */
   static const StaticWarningCode NON_ABSTRACT_CLASS_INHERITS_ABSTRACT_MEMBER_FOUR =
       const StaticWarningCode(
           'NON_ABSTRACT_CLASS_INHERITS_ABSTRACT_MEMBER_FOUR',
           "Missing concrete implementation of {0}, {1}, {2} and {3}");
 
   /**
    * 7.9.1 Inheritance and Overriding: It is a static warning if a non-abstract
    * class inherits an abstract method.
    *
    * 7.10 Superinterfaces: Let <i>C</i> be a concrete class that does not
    * declare its own <i>noSuchMethod()</i> method. It is a static warning if the
    * implicit interface of <i>C</i> includes an instance member <i>m</i> of type
    * <i>F</i> and <i>C</i> does not declare or inherit a corresponding instance
    * member <i>m</i> of type <i>F'</i> such that <i>F' <: F</i>.
    *
    * 7.4 Abstract Instance Members: It is a static warning if an abstract member
    * is declared or inherited in a concrete class unless that member overrides a
    * concrete one.
    *
-   * @param memberName the name of the member
+   * Parameters:
+   * 0: the name of the member
    */
   static const StaticWarningCode NON_ABSTRACT_CLASS_INHERITS_ABSTRACT_MEMBER_ONE =
       const StaticWarningCode('NON_ABSTRACT_CLASS_INHERITS_ABSTRACT_MEMBER_ONE',
           "Missing concrete implementation of {0}");
 
   /**
    * 7.9.1 Inheritance and Overriding: It is a static warning if a non-abstract
    * class inherits an abstract method.
    *
    * 7.10 Superinterfaces: Let <i>C</i> be a concrete class that does not
    * declare its own <i>noSuchMethod()</i> method. It is a static warning if the
    * implicit interface of <i>C</i> includes an instance member <i>m</i> of type
    * <i>F</i> and <i>C</i> does not declare or inherit a corresponding instance
    * member <i>m</i> of type <i>F'</i> such that <i>F' <: F</i>.
    *
    * 7.4 Abstract Instance Members: It is a static warning if an abstract member
    * is declared or inherited in a concrete class unless that member overrides a
    * concrete one.
    *
-   * @param memberName the name of the first member
-   * @param memberName the name of the second member
-   * @param memberName the name of the third member
+   * Parameters:
+   * 0: the name of the first member
+   * 1: the name of the second member
+   * 2: the name of the third member
    */
   static const StaticWarningCode NON_ABSTRACT_CLASS_INHERITS_ABSTRACT_MEMBER_THREE =
       const StaticWarningCode(
           'NON_ABSTRACT_CLASS_INHERITS_ABSTRACT_MEMBER_THREE',
           "Missing concrete implementation of {0}, {1} and {2}");
 
   /**
    * 7.9.1 Inheritance and Overriding: It is a static warning if a non-abstract
    * class inherits an abstract method.
    *
    * 7.10 Superinterfaces: Let <i>C</i> be a concrete class that does not
    * declare its own <i>noSuchMethod()</i> method. It is a static warning if the
    * implicit interface of <i>C</i> includes an instance member <i>m</i> of type
    * <i>F</i> and <i>C</i> does not declare or inherit a corresponding instance
    * member <i>m</i> of type <i>F'</i> such that <i>F' <: F</i>.
    *
    * 7.4 Abstract Instance Members: It is a static warning if an abstract member
    * is declared or inherited in a concrete class unless that member overrides a
    * concrete one.
    *
-   * @param memberName the name of the first member
-   * @param memberName the name of the second member
+   * Parameters:
+   * 0: the name of the first member
+   * 1: the name of the second member
    */
   static const StaticWarningCode NON_ABSTRACT_CLASS_INHERITS_ABSTRACT_MEMBER_TWO =
       const StaticWarningCode('NON_ABSTRACT_CLASS_INHERITS_ABSTRACT_MEMBER_TWO',
           "Missing concrete implementation of {0} and {1}");
 
   /**
    * 13.11 Try: An on-catch clause of the form <i>on T catch (p<sub>1</sub>,
    * p<sub>2</sub>) s</i> or <i>on T s</i> matches an object <i>o</i> if the
    * type of <i>o</i> is a subtype of <i>T</i>. It is a static warning if
    * <i>T</i> does not denote a type available in the lexical scope of the
    * catch clause.
    *
-   * @param name the name of the non-type element
+   * Parameters:
+   * 0: the name of the non-type element
    */
   static const StaticWarningCode NON_TYPE_IN_CATCH_CLAUSE =
       const StaticWarningCode('NON_TYPE_IN_CATCH_CLAUSE',
           "The name '{0}' is not a type and cannot be used in an on-catch clause");
 
   /**
    * 7.1.1 Operators: It is a static warning if the return type of the
    * user-declared operator []= is explicitly declared and not void.
    */
   static const StaticWarningCode NON_VOID_RETURN_FOR_OPERATOR =
@@ skipping 13 matching lines @@
    * * <i>T</i> has the form <i>id</i> or the form <i>prefix.id</i>, and in the
    *   enclosing lexical scope, the name <i>id</i> (respectively
    *   <i>prefix.id</i>) does not denote a type.
    * * <i>T</i> denotes a type parameter in the enclosing lexical scope, but
    * occurs in the signature or body of a static member.
    * * <i>T</i> is a parameterized type of the form <i>G&lt;S<sub>1</sub>, ..,
    * S<sub>n</sub>&gt;</i>,
    *
    * Any use of a malformed type gives rise to a static warning.
    *
-   * @param nonTypeName the name that is not a type
+   * Parameters:
+   * 0: the name that is not a type
    */
   static const StaticWarningCode NOT_A_TYPE =
       const StaticWarningCode('NOT_A_TYPE', "{0} is not a type");
 
   /**
    * 12.14.2 Binding Actuals to Formals: It is a static warning if <i>m &lt;
    * h</i> or if <i>m &gt; n</i>.
    *
-   * @param requiredCount the expected number of required arguments
-   * @param argumentCount the actual number of positional arguments given
+   * Parameters:
+   * 0: the expected number of required arguments
+   * 1: the actual number of positional arguments given
+   *
    * See [EXTRA_POSITIONAL_ARGUMENTS].
    */
   static const StaticWarningCode NOT_ENOUGH_REQUIRED_ARGUMENTS =
       const StaticWarningCode('NOT_ENOUGH_REQUIRED_ARGUMENTS',
           "{0} required argument(s) expected, but {1} found");
 
   /**
    * 14.3 Parts: It is a static warning if the referenced part declaration
    * <i>p</i> names a library other than the current library as the library to
    * which <i>p</i> belongs.
    *
-   * @param expectedLibraryName the name of expected library name
-   * @param actualLibraryName the non-matching actual library name from the
-   *        "part of" declaration
+   * Parameters:
+   * 0: the name of expected library name
+   * 1: the non-matching actual library name from the "part of" declaration
    */
   static const StaticWarningCode PART_OF_DIFFERENT_LIBRARY =
       const StaticWarningCode('PART_OF_DIFFERENT_LIBRARY',
           "Expected this library to be part of '{0}', not '{1}'");
 
   /**
    * 7.6.2 Factories: It is a static warning if the function type of <i>k'</i>
    * is not a subtype of the type of <i>k</i>.
    *
-   * @param redirectedName the name of the redirected constructor
-   * @param redirectingName the name of the redirecting constructor
+   * Parameters:
+   * 0: the name of the redirected constructor
+   * 1: the name of the redirecting constructor
    */
   static const StaticWarningCode REDIRECT_TO_INVALID_FUNCTION_TYPE =
       const StaticWarningCode('REDIRECT_TO_INVALID_FUNCTION_TYPE',
           "The redirected constructor '{0}' has incompatible parameters with '{1}'");
 
   /**
    * 7.6.2 Factories: It is a static warning if the function type of <i>k'</i>
    * is not a subtype of the type of <i>k</i>.
    *
-   * @param redirectedName the name of the redirected constructor return type
-   * @param redirectingName the name of the redirecting constructor return type
+   * Parameters:
+   * 0: the name of the redirected constructor return type
+   * 1: the name of the redirecting constructor return type
    */
   static const StaticWarningCode REDIRECT_TO_INVALID_RETURN_TYPE =
       const StaticWarningCode('REDIRECT_TO_INVALID_RETURN_TYPE',
           "The return type '{0}' of the redirected constructor is not assignable to '{1}'");
 
   /**
    * 7.6.2 Factories: It is a static warning if type does not denote a class
    * accessible in the current scope; if type does denote such a class <i>C</i>
    * it is a static warning if the referenced constructor (be it <i>type</i> or
    * <i>type.id</i>) is not a constructor of <i>C</i>.
@@ skipping 19 matching lines @@
    * * <i>f</i> is not a generative constructor.
    * * The return type of <i>f</i> may not be assigned to void.
    */
   static const StaticWarningCode RETURN_WITHOUT_VALUE = const StaticWarningCode(
       'RETURN_WITHOUT_VALUE', "Missing return value after 'return'");
 
   /**
    * 12.16.3 Static Invocation: It is a static warning if <i>C</i> does not
    * declare a static method or getter <i>m</i>.
    *
-   * @param memberName the name of the instance member
+   * Parameters:
+   * 0: the name of the instance member
    */
   static const StaticWarningCode STATIC_ACCESS_TO_INSTANCE_MEMBER =
       const StaticWarningCode('STATIC_ACCESS_TO_INSTANCE_MEMBER',
           "Instance member '{0}' cannot be accessed using static access");
 
   /**
    * 13.9 Switch: It is a static warning if the type of <i>e</i> may not be
    * assigned to the type of <i>e<sub>k</sub></i>.
    */
   static const StaticWarningCode SWITCH_EXPRESSION_NOT_ASSIGNABLE =
       const StaticWarningCode('SWITCH_EXPRESSION_NOT_ASSIGNABLE',
           "Type '{0}' of the switch expression is not assignable to the type '{1}' of case expressions");
 
   /**
    * 15.1 Static Types: It is a static warning to use a deferred type in a type
    * annotation.
    *
-   * @param name the name of the type that is deferred and being used in a type
-   *        annotation
+   * Parameters:
+   * 0: the name of the type that is deferred and being used in a type
+   *    annotation
    */
   static const StaticWarningCode TYPE_ANNOTATION_DEFERRED_CLASS =
       const StaticWarningCode('TYPE_ANNOTATION_DEFERRED_CLASS',
           "The deferred type '{0}' cannot be used in a declaration, cast or type test");
 
   /**
    * 12.31 Type Test: It is a static warning if <i>T</i> does not denote a type
    * available in the current lexical scope.
    */
   static const StaticWarningCode TYPE_TEST_WITH_NON_TYPE = const StaticWarningCode(
@@ skipping 19 matching lines @@
   static const StaticWarningCode TYPE_PARAMETER_REFERENCED_BY_STATIC =
       const StaticWarningCode('TYPE_PARAMETER_REFERENCED_BY_STATIC',
           "Static members cannot reference type parameters");
 
   /**
    * 12.16.3 Static Invocation: A static method invocation <i>i</i> has the form
    * <i>C.m(a<sub>1</sub>, &hellip;, a<sub>n</sub>, x<sub>n+1</sub>:
    * a<sub>n+1</sub>, &hellip; x<sub>n+k</sub>: a<sub>n+k</sub>)</i>. It is a
    * static warning if <i>C</i> does not denote a class in the current scope.
    *
-   * @param undefinedClassName the name of the undefined class
+   * Parameters:
+   * 0: the name of the undefined class
    */
   static const StaticWarningCode UNDEFINED_CLASS =
       const StaticWarningCode('UNDEFINED_CLASS', "Undefined class '{0}'");
 
   /**
    * Same as [UNDEFINED_CLASS], but to catch using "boolean" instead of "bool".
    */
   static const StaticWarningCode UNDEFINED_CLASS_BOOLEAN =
       const StaticWarningCode('UNDEFINED_CLASS_BOOLEAN',
           "Undefined class 'boolean'; did you mean 'bool'?");
 
   /**
    * 12.17 Getter Invocation: It is a static warning if there is no class
    * <i>C</i> in the enclosing lexical scope of <i>i</i>, or if <i>C</i> does
    * not declare, implicitly or explicitly, a getter named <i>m</i>.
    *
-   * @param getterName the name of the getter
-   * @param enclosingType the name of the enclosing type where the getter is
-   *        being looked for
+   * Parameters:
+   * 0: the name of the getter
+   * 1: the name of the enclosing type where the getter is being looked for
    */
   static const StaticWarningCode UNDEFINED_GETTER = const StaticWarningCode(
       'UNDEFINED_GETTER',
       "The getter '{0}' is not defined for the class '{1}'");
 
   /**
    * 12.30 Identifier Reference: It is as static warning if an identifier
    * expression of the form <i>id</i> occurs inside a top level or static
    * function (be it function, method, getter, or setter) or variable
    * initializer and there is no declaration <i>d</i> with name <i>id</i> in the
    * lexical scope enclosing the expression.
    *
-   * @param name the name of the identifier
+   * Parameters:
+   * 0: the name of the identifier
    */
   static const StaticWarningCode UNDEFINED_IDENTIFIER =
       const StaticWarningCode('UNDEFINED_IDENTIFIER', "Undefined name '{0}'");
 
   /**
    * 12.14.2 Binding Actuals to Formals: Furthermore, each <i>q<sub>i</sub></i>,
    * <i>1<=i<=l</i>, must have a corresponding named parameter in the set
    * {<i>p<sub>n+1</sub></i> &hellip; <i>p<sub>n+k</sub></i>} or a static
    * warning occurs.
    *
-   * @param name the name of the requested named parameter
+   * Parameters:
+   * 0: the name of the requested named parameter
    */
   static const StaticWarningCode UNDEFINED_NAMED_PARAMETER =
       const StaticWarningCode('UNDEFINED_NAMED_PARAMETER',
           "The named parameter '{0}' is not defined");
 
   /**
    * 12.18 Assignment: It is as static warning if an assignment of the form
    * <i>v = e</i> occurs inside a top level or static function (be it function,
    * method, getter, or setter) or variable initializer and there is no
    * declaration <i>d</i> with name <i>v=</i> in the lexical scope enclosing the
    * assignment.
    *
    * 12.18 Assignment: It is a static warning if there is no class <i>C</i> in
    * the enclosing lexical scope of the assignment, or if <i>C</i> does not
    * declare, implicitly or explicitly, a setter <i>v=</i>.
    *
-   * @param setterName the name of the getter
-   * @param enclosingType the name of the enclosing type where the setter is
-   *        being looked for
+   * Parameters:
+   * 0: the name of the getter
+   * 1: the name of the enclosing type where the setter is being looked for
    */
   static const StaticWarningCode UNDEFINED_SETTER = const StaticWarningCode(
       'UNDEFINED_SETTER',
       "The setter '{0}' is not defined for the class '{1}'");
 
   /**
    * 12.16.3 Static Invocation: It is a static warning if <i>C</i> does not
    * declare a static method or getter <i>m</i>.
    *
-   * @param methodName the name of the method
-   * @param enclosingType the name of the enclosing type where the method is
-   *        being looked for
+   * Parameters:
+   * 0: the name of the method
+   * 1: the name of the enclosing type where the method is being looked for
    */
   static const StaticWarningCode UNDEFINED_STATIC_METHOD_OR_GETTER =
       const StaticWarningCode('UNDEFINED_STATIC_METHOD_OR_GETTER',
           "The static method, getter or setter '{0}' is not defined for the class '{1}'");
 
   /**
    * 12.17 Getter Invocation: It is a static warning if there is no class
    * <i>C</i> in the enclosing lexical scope of <i>i</i>, or if <i>C</i> does
    * not declare, implicitly or explicitly, a getter named <i>m</i>.
    *
-   * @param getterName the name of the getter
-   * @param enclosingType the name of the enclosing type where the getter is
-   *        being looked for
+   * Parameters:
+   * 0: the name of the getter
+   * 1: the name of the enclosing type where the getter is being looked for
    */
   static const StaticWarningCode UNDEFINED_SUPER_GETTER =
       const StaticWarningCode('UNDEFINED_SUPER_GETTER',
           "The getter '{0}' is not defined in a superclass of '{1}'");
 
   /**
    * 12.18 Assignment: It is as static warning if an assignment of the form
    * <i>v = e</i> occurs inside a top level or static function (be it function,
    * method, getter, or setter) or variable initializer and there is no
    * declaration <i>d</i> with name <i>v=</i> in the lexical scope enclosing the
    * assignment.
    *
    * 12.18 Assignment: It is a static warning if there is no class <i>C</i> in
    * the enclosing lexical scope of the assignment, or if <i>C</i> does not
    * declare, implicitly or explicitly, a setter <i>v=</i>.
    *
-   * @param setterName the name of the getter
-   * @param enclosingType the name of the enclosing type where the setter is
-   *        being looked for
+   * Parameters:
+   * 0: the name of the getter
+   * 1: the name of the enclosing type where the setter is being looked for
    */
   static const StaticWarningCode UNDEFINED_SUPER_SETTER =
       const StaticWarningCode('UNDEFINED_SUPER_SETTER',
           "The setter '{0}' is not defined in a superclass of '{1}'");
 
   /**
    * 7.2 Getters: It is a static warning if the return type of a getter is void.
    */
   static const StaticWarningCode VOID_RETURN_FOR_GETTER =
       const StaticWarningCode('VOID_RETURN_FOR_GETTER',
           "The return type of the getter must not be 'void'");
 
   /**
    * Initialize a newly created error code to have the given [name]. The message
    * associated with the error will be created from the given [message]
    * template. The correction associated with the error will be created from the
    * given [correction] template.
    */
   const StaticWarningCode(String name, String message, [String correction])
       : super(name, message, correction);
 
   @override
   ErrorSeverity get errorSeverity => ErrorType.STATIC_WARNING.severity;
 
   @override
   ErrorType get type => ErrorType.STATIC_WARNING;
 }
 
 /**
- * The class `TodoCode` defines the single TODO error code.
+ * The error code indicating a marker in code for work that needs to be finished
+ * or revisited.
  */
 class TodoCode extends ErrorCode {
   /**
    * The single enum of TodoCode.
    */
   static const TodoCode TODO = const TodoCode('TODO');
 
   /**
    * This matches the two common Dart task styles
    *
@@ skipping 14 matching lines @@
    * Initialize a newly created error code to have the given [name].
    */
   const TodoCode(String name) : super(name, "{0}");
 
   @override
   ErrorSeverity get errorSeverity => ErrorSeverity.INFO;
 
   @override
   ErrorType get type => ErrorType.TODO;
 }