| Index: pkg/analyzer/lib/src/generated/error.dart
|
| diff --git a/pkg/analyzer/lib/src/generated/error.dart b/pkg/analyzer/lib/src/generated/error.dart
|
| index 6566108e7fefdad5f22c999528540926e6c9c51b..8c27bc0cb281d5534071638008da06a73bfcef16 100644
|
| --- a/pkg/analyzer/lib/src/generated/error.dart
|
| +++ b/pkg/analyzer/lib/src/generated/error.dart
|
| @@ -13,8 +13,7 @@ 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].
|
| */
|
| @@ -25,15 +24,15 @@ class AnalysisError {
|
| 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) {
|
| @@ -61,8 +60,8 @@ class AnalysisError {
|
| 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;
|
|
|
| @@ -78,37 +77,31 @@ class AnalysisError {
|
| 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]) {
|
| @@ -121,10 +114,9 @@ class AnalysisError {
|
| }
|
|
|
| /**
|
| - * 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;
|
|
|
| @@ -137,18 +129,15 @@ class AnalysisError {
|
| }
|
|
|
| /**
|
| - * 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;
|
|
|
| @@ -184,11 +173,8 @@ class AnalysisError {
|
| }
|
|
|
| /**
|
| - * 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;
|
|
|
| @@ -208,8 +194,8 @@ class AnalysisError {
|
| }
|
|
|
| /**
|
| - * 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 {
|
| /**
|
| @@ -219,13 +205,15 @@ abstract class AnalysisErrorListener {
|
| 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) {
|
| @@ -234,7 +222,7 @@ class AnalysisErrorListener_NULL_LISTENER implements AnalysisErrorListener {
|
| }
|
|
|
| /**
|
| - * Instances of the class `AnalysisErrorWithProperties`
|
| + * An [AnalysisError] that can have arbitrary properties associated with it.
|
| */
|
| class AnalysisErrorWithProperties extends AnalysisError {
|
| /**
|
| @@ -244,25 +232,19 @@ class AnalysisErrorWithProperties extends AnalysisError {
|
| 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)
|
| @@ -272,11 +254,8 @@ class AnalysisErrorWithProperties extends AnalysisError {
|
| 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;
|
| @@ -284,8 +263,8 @@ class AnalysisErrorWithProperties extends AnalysisError {
|
| }
|
|
|
| /**
|
| - * 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 {
|
| /**
|
| @@ -295,8 +274,6 @@ class BooleanErrorListener implements AnalysisErrorListener {
|
|
|
| /**
|
| * 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;
|
|
|
| @@ -307,12 +284,12 @@ class BooleanErrorListener implements AnalysisErrorListener {
|
| }
|
|
|
| /**
|
| - * 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
|
| @@ -348,8 +325,9 @@ class CheckedModeCompileTimeErrorCode extends ErrorCode {
|
| * 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(
|
| @@ -438,11 +416,10 @@ class CheckedModeCompileTimeErrorCode extends ErrorCode {
|
| }
|
|
|
| /**
|
| - * 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 {
|
| /**
|
| @@ -459,11 +436,10 @@ class CompileTimeErrorCode extends ErrorCode {
|
| * 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',
|
| @@ -473,8 +449,9 @@ class CompileTimeErrorCode extends ErrorCode {
|
| * 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(
|
| @@ -713,7 +690,8 @@ class CompileTimeErrorCode extends ErrorCode {
|
| * 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',
|
| @@ -777,9 +755,11 @@ class CompileTimeErrorCode extends ErrorCode {
|
| * …, U<sub>m</sub>></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].
|
| */
|
| @@ -817,7 +797,8 @@ class CompileTimeErrorCode extends ErrorCode {
|
| * <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(
|
| @@ -835,8 +816,9 @@ class CompileTimeErrorCode extends ErrorCode {
|
| * 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',
|
| @@ -846,7 +828,8 @@ class CompileTimeErrorCode extends ErrorCode {
|
| * 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',
|
| @@ -891,7 +874,8 @@ class CompileTimeErrorCode extends ErrorCode {
|
| * 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',
|
| @@ -907,7 +891,8 @@ class CompileTimeErrorCode extends ErrorCode {
|
| * 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(
|
| @@ -920,9 +905,10 @@ class CompileTimeErrorCode extends ErrorCode {
|
| * 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 =
|
| @@ -941,7 +927,8 @@ class CompileTimeErrorCode extends ErrorCode {
|
| /**
|
| * 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',
|
| @@ -951,7 +938,8 @@ class CompileTimeErrorCode extends ErrorCode {
|
| * 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',
|
| @@ -969,7 +957,8 @@ class CompileTimeErrorCode extends ErrorCode {
|
| * 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(
|
| @@ -995,7 +984,9 @@ class CompileTimeErrorCode extends ErrorCode {
|
| * 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 =
|
| @@ -1006,7 +997,9 @@ class CompileTimeErrorCode extends ErrorCode {
|
| * 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 =
|
| @@ -1020,8 +1013,9 @@ class CompileTimeErrorCode extends ErrorCode {
|
| * 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',
|
| @@ -1052,7 +1046,8 @@ class CompileTimeErrorCode extends ErrorCode {
|
| * 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',
|
| @@ -1092,7 +1087,8 @@ class CompileTimeErrorCode extends ErrorCode {
|
| * 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',
|
| @@ -1103,7 +1099,9 @@ class CompileTimeErrorCode extends ErrorCode {
|
| * 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 =
|
| @@ -1130,7 +1128,9 @@ class CompileTimeErrorCode extends ErrorCode {
|
| * 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 =
|
| @@ -1158,7 +1158,8 @@ class CompileTimeErrorCode extends ErrorCode {
|
| * 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(
|
| @@ -1168,7 +1169,8 @@ class CompileTimeErrorCode extends ErrorCode {
|
| * 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(
|
| @@ -1178,8 +1180,9 @@ class CompileTimeErrorCode extends ErrorCode {
|
| * 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',
|
| @@ -1194,7 +1197,8 @@ class CompileTimeErrorCode extends ErrorCode {
|
| * 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',
|
| @@ -1203,7 +1207,8 @@ class CompileTimeErrorCode extends ErrorCode {
|
| /**
|
| * 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',
|
| @@ -1213,7 +1218,9 @@ class CompileTimeErrorCode extends ErrorCode {
|
| * 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 =
|
| @@ -1225,9 +1232,9 @@ class CompileTimeErrorCode extends ErrorCode {
|
| * <i>e<sub>k</sub></i> are not instances of the same class <i>C</i>, for all
|
| * <i>1 <= k <= 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',
|
| @@ -1239,8 +1246,10 @@ class CompileTimeErrorCode extends ErrorCode {
|
| * 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 =
|
| @@ -1253,8 +1262,10 @@ class CompileTimeErrorCode extends ErrorCode {
|
| * 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 =
|
| @@ -1266,8 +1277,10 @@ class CompileTimeErrorCode extends ErrorCode {
|
| * <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].
|
| */
|
| @@ -1280,8 +1293,10 @@ class CompileTimeErrorCode extends ErrorCode {
|
| * <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 =
|
| @@ -1400,7 +1415,8 @@ class CompileTimeErrorCode extends ErrorCode {
|
| * 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',
|
| @@ -1410,7 +1426,8 @@ class CompileTimeErrorCode extends ErrorCode {
|
| * 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',
|
| @@ -1426,7 +1443,9 @@ class CompileTimeErrorCode extends ErrorCode {
|
| * 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 =
|
| @@ -1441,7 +1460,8 @@ class CompileTimeErrorCode extends ErrorCode {
|
| * 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',
|
| @@ -1456,7 +1476,8 @@ class CompileTimeErrorCode extends ErrorCode {
|
| * 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(
|
| @@ -1474,7 +1495,8 @@ class CompileTimeErrorCode extends ErrorCode {
|
| * 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',
|
| @@ -1501,9 +1523,11 @@ class CompileTimeErrorCode extends ErrorCode {
|
| * * The static type of <i>e</i> is an enumerated typed with elements
|
| * <i>id<sub>1</sub></i>, …, <i>id<sub>n</sub></i>.
|
| * * The sets {<i>e<sub>1</sub></i>, …, <i>e<sub>k</sub></i>} and
|
| - * {<i>id<sub>1</sub></i>, …, <i>id<sub>n</sub></i>} are not the same.
|
| + * {<i>id<sub>1</sub></i>, …, <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',
|
| @@ -1514,7 +1538,8 @@ class CompileTimeErrorCode extends ErrorCode {
|
| * 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',
|
| @@ -1524,7 +1549,9 @@ class CompileTimeErrorCode extends ErrorCode {
|
| * 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 =
|
| @@ -1547,7 +1574,8 @@ class CompileTimeErrorCode extends ErrorCode {
|
| * 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',
|
| @@ -1572,7 +1600,9 @@ class CompileTimeErrorCode extends ErrorCode {
|
| * 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 =
|
| @@ -1827,8 +1857,9 @@ class CompileTimeErrorCode extends ErrorCode {
|
| * 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',
|
| @@ -1864,7 +1895,8 @@ class CompileTimeErrorCode extends ErrorCode {
|
| * 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',
|
| @@ -1926,8 +1958,9 @@ class CompileTimeErrorCode extends ErrorCode {
|
| * 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',
|
| @@ -1943,7 +1976,8 @@ class CompileTimeErrorCode extends ErrorCode {
|
| * 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(
|
| @@ -1960,7 +1994,8 @@ class CompileTimeErrorCode extends ErrorCode {
|
| * 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(
|
| @@ -1977,7 +2012,8 @@ class CompileTimeErrorCode extends ErrorCode {
|
| * 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(
|
| @@ -2109,10 +2145,11 @@ class CompileTimeErrorCode extends ErrorCode {
|
| * 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 =
|
| @@ -2165,7 +2202,8 @@ class CompileTimeErrorCode extends ErrorCode {
|
| * 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',
|
| @@ -2181,7 +2219,9 @@ class CompileTimeErrorCode extends ErrorCode {
|
| * 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 =
|
| @@ -2212,10 +2252,10 @@ class CompileTimeErrorCode extends ErrorCode {
|
| * 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',
|
| @@ -2225,8 +2265,8 @@ class CompileTimeErrorCode extends ErrorCode {
|
| * 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(
|
| @@ -2274,7 +2314,7 @@ class CompileTimeErrorCode extends ErrorCode {
|
| }
|
|
|
| /**
|
| - * 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:
|
| @@ -2333,8 +2373,7 @@ abstract class ErrorCode {
|
| }
|
|
|
| /**
|
| - * 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> {
|
| /**
|
| @@ -2350,8 +2389,8 @@ class ErrorProperty extends Enum<ErrorProperty> {
|
| }
|
|
|
| /**
|
| - * 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 {
|
| /**
|
| @@ -2370,10 +2409,9 @@ class ErrorReporter {
|
| 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) {
|
| @@ -2387,21 +2425,16 @@ class ErrorReporter {
|
| 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) =>
|
| @@ -2409,20 +2442,15 @@ class ErrorReporter {
|
| _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) {
|
| @@ -2431,15 +2459,12 @@ class ErrorReporter {
|
| }
|
|
|
| /**
|
| - * 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]) {
|
| @@ -2447,12 +2472,8 @@ class ErrorReporter {
|
| }
|
|
|
| /**
|
| - * 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]) {
|
| @@ -2461,11 +2482,8 @@ class ErrorReporter {
|
| }
|
|
|
| /**
|
| - * 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]) {
|
| @@ -2473,17 +2491,15 @@ class ErrorReporter {
|
| }
|
|
|
| /**
|
| - * 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) {
|
| @@ -2492,12 +2508,11 @@ class ErrorReporter {
|
| }
|
|
|
| /**
|
| - * 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)) {
|
| @@ -2526,12 +2541,8 @@ class ErrorReporter {
|
| }
|
|
|
| /**
|
| - * 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;
|
| @@ -2547,13 +2558,12 @@ class ErrorReporter {
|
| }
|
|
|
| /**
|
| - * 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");
|
|
|
| @@ -2590,8 +2600,9 @@ class ErrorSeverity extends Enum<ErrorSeverity> {
|
| /**
|
| * 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)
|
| @@ -2599,16 +2610,13 @@ class ErrorSeverity extends Enum<ErrorSeverity> {
|
|
|
| /**
|
| * 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> {
|
| /**
|
| @@ -2617,47 +2625,51 @@ class ErrorType extends Enum<ErrorType> {
|
| 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);
|
|
|
| @@ -2678,9 +2690,8 @@ class ErrorType extends Enum<ErrorType> {
|
| 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);
|
| @@ -2689,8 +2700,8 @@ class ErrorType extends Enum<ErrorType> {
|
| }
|
|
|
| /**
|
| - * 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 {
|
| /**
|
| @@ -2698,8 +2709,9 @@ class HintCode extends ErrorCode {
|
| * [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',
|
| @@ -2724,8 +2736,9 @@ class HintCode extends ErrorCode {
|
| * 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',
|
| @@ -2734,7 +2747,8 @@ class HintCode extends ErrorCode {
|
| /**
|
| * 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");
|
| @@ -2788,8 +2802,9 @@ class HintCode extends ErrorCode {
|
| * [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',
|
| @@ -2801,7 +2816,8 @@ class HintCode extends ErrorCode {
|
| * 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",
|
| @@ -2831,7 +2847,8 @@ class HintCode extends ErrorCode {
|
| /**
|
| * 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',
|
| @@ -2856,9 +2873,9 @@ class HintCode extends ErrorCode {
|
| * [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}'");
|
| @@ -2868,9 +2885,9 @@ class HintCode extends ErrorCode {
|
| * [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}'");
|
| @@ -2880,9 +2897,9 @@ class HintCode extends ErrorCode {
|
| * [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',
|
| @@ -2894,9 +2911,9 @@ class HintCode extends ErrorCode {
|
| * [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}'");
|
| @@ -2950,7 +2967,8 @@ class HintCode extends ErrorCode {
|
| * 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',
|
| @@ -3005,18 +3023,18 @@ class HintCode extends ErrorCode {
|
| }
|
|
|
| /**
|
| - * 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}'");
|
| @@ -3025,7 +3043,8 @@ class HtmlWarningCode extends ErrorCode {
|
| * 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}'");
|
| @@ -3049,8 +3068,9 @@ class HtmlWarningCode extends ErrorCode {
|
| /**
|
| * 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])
|
| @@ -3064,18 +3084,18 @@ class LintCode extends ErrorCode {
|
| }
|
|
|
| /**
|
| - * 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<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',
|
| @@ -3085,7 +3105,8 @@ class StaticTypeWarningCode extends ErrorCode {
|
| * 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<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',
|
| @@ -3161,7 +3182,9 @@ class StaticTypeWarningCode extends ErrorCode {
|
| * 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 =
|
| @@ -3181,8 +3204,9 @@ class StaticTypeWarningCode extends ErrorCode {
|
| * 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',
|
| @@ -3209,8 +3233,8 @@ class StaticTypeWarningCode extends ErrorCode {
|
| * <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(
|
| @@ -3270,7 +3294,8 @@ class StaticTypeWarningCode extends ErrorCode {
|
| * 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',
|
| @@ -3289,9 +3314,10 @@ class StaticTypeWarningCode extends ErrorCode {
|
| * 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',
|
| @@ -3318,10 +3344,11 @@ class StaticTypeWarningCode extends ErrorCode {
|
| * 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 =
|
| @@ -3332,7 +3359,9 @@ class StaticTypeWarningCode extends ErrorCode {
|
| * 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 =
|
| @@ -3344,9 +3373,9 @@ class StaticTypeWarningCode extends ErrorCode {
|
| * <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',
|
| @@ -3361,7 +3390,8 @@ class StaticTypeWarningCode extends ErrorCode {
|
| * <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(
|
| @@ -3371,9 +3401,9 @@ class StaticTypeWarningCode extends ErrorCode {
|
| * 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',
|
| @@ -3384,9 +3414,9 @@ class StaticTypeWarningCode extends ErrorCode {
|
| * 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',
|
| @@ -3408,9 +3438,9 @@ class StaticTypeWarningCode extends ErrorCode {
|
| * 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',
|
| @@ -3421,9 +3451,10 @@ class StaticTypeWarningCode extends ErrorCode {
|
| * 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 =
|
| @@ -3434,9 +3465,9 @@ class StaticTypeWarningCode extends ErrorCode {
|
| * 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',
|
| @@ -3449,9 +3480,9 @@ class StaticTypeWarningCode extends ErrorCode {
|
| * 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',
|
| @@ -3473,9 +3504,9 @@ class StaticTypeWarningCode extends ErrorCode {
|
| * 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',
|
| @@ -3486,9 +3517,10 @@ class StaticTypeWarningCode extends ErrorCode {
|
| * 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 =
|
| @@ -3512,9 +3544,11 @@ class StaticTypeWarningCode extends ErrorCode {
|
| * 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].
|
| */
|
| @@ -3561,11 +3595,10 @@ class StaticTypeWarningCode extends ErrorCode {
|
| }
|
|
|
| /**
|
| - * 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 {
|
| /**
|
| @@ -3577,11 +3610,10 @@ class StaticWarningCode extends ErrorCode {
|
| * <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}",
|
| @@ -3613,8 +3645,9 @@ class StaticWarningCode extends ErrorCode {
|
| * assigned to <i>S<sub>r</sub></i>, where <i>r = q<sub>j</sub>, 1 <= j
|
| * <= 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',
|
| @@ -3699,11 +3732,10 @@ class StaticWarningCode extends ErrorCode {
|
| * * 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',
|
| @@ -3714,7 +3746,8 @@ class StaticWarningCode extends ErrorCode {
|
| * 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(
|
| @@ -3742,7 +3775,8 @@ class StaticWarningCode extends ErrorCode {
|
| * 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(
|
| @@ -3786,9 +3820,10 @@ class StaticWarningCode extends ErrorCode {
|
| * 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',
|
| @@ -3798,8 +3833,9 @@ class StaticWarningCode extends ErrorCode {
|
| * 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',
|
| @@ -3809,8 +3845,10 @@ class StaticWarningCode extends ErrorCode {
|
| * 12.14.2 Binding Actuals to Formals: It is a static warning if <i>m <
|
| * h</i> or if <i>m > 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 =
|
| @@ -3832,7 +3870,8 @@ class StaticWarningCode extends ErrorCode {
|
| * 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(
|
| @@ -3852,8 +3891,9 @@ class StaticWarningCode extends ErrorCode {
|
| * warning if <i>T<sub>j</sub></i> may not be assigned to <i>S<sub>j</sub>, 1
|
| * <= j <= 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',
|
| @@ -3864,8 +3904,9 @@ class StaticWarningCode extends ErrorCode {
|
| * <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',
|
| @@ -3884,7 +3925,8 @@ class StaticWarningCode extends ErrorCode {
|
| * * 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',
|
| @@ -3902,9 +3944,10 @@ class StaticWarningCode extends ErrorCode {
|
| * 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',
|
| @@ -3914,8 +3957,9 @@ class StaticWarningCode extends ErrorCode {
|
| * 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',
|
| @@ -3925,7 +3969,9 @@ class StaticWarningCode extends ErrorCode {
|
| * 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 =
|
| @@ -3953,9 +3999,9 @@ class StaticWarningCode extends ErrorCode {
|
| * 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(
|
| @@ -3967,11 +4013,12 @@ class StaticWarningCode extends ErrorCode {
|
| * 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 =
|
| @@ -3983,11 +4030,11 @@ class StaticWarningCode extends ErrorCode {
|
| * <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',
|
| @@ -3998,11 +4045,11 @@ class StaticWarningCode extends ErrorCode {
|
| * <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 =
|
| @@ -4014,11 +4061,11 @@ class StaticWarningCode extends ErrorCode {
|
| * <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',
|
| @@ -4029,11 +4076,12 @@ class StaticWarningCode extends ErrorCode {
|
| * <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 =
|
| @@ -4068,8 +4116,9 @@ class StaticWarningCode extends ErrorCode {
|
| * <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',
|
| @@ -4080,9 +4129,9 @@ class StaticWarningCode extends ErrorCode {
|
| * <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',
|
| @@ -4093,9 +4142,9 @@ class StaticWarningCode extends ErrorCode {
|
| * <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',
|
| @@ -4106,11 +4155,12 @@ class StaticWarningCode extends ErrorCode {
|
| * 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 =
|
| @@ -4212,9 +4262,11 @@ class StaticWarningCode extends ErrorCode {
|
| * 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].
|
| */
|
| @@ -4226,7 +4278,8 @@ class StaticWarningCode extends ErrorCode {
|
| * 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");
|
| @@ -4278,12 +4331,12 @@ class StaticWarningCode extends ErrorCode {
|
| * 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(
|
| @@ -4304,10 +4357,11 @@ class StaticWarningCode extends ErrorCode {
|
| * 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(
|
| @@ -4328,7 +4382,8 @@ class StaticWarningCode extends ErrorCode {
|
| * 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',
|
| @@ -4348,9 +4403,10 @@ class StaticWarningCode extends ErrorCode {
|
| * 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(
|
| @@ -4371,8 +4427,9 @@ class StaticWarningCode extends ErrorCode {
|
| * 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',
|
| @@ -4385,7 +4442,8 @@ class StaticWarningCode extends ErrorCode {
|
| * <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',
|
| @@ -4419,7 +4477,8 @@ class StaticWarningCode extends ErrorCode {
|
| *
|
| * 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");
|
| @@ -4428,8 +4487,10 @@ class StaticWarningCode extends ErrorCode {
|
| * 12.14.2 Binding Actuals to Formals: It is a static warning if <i>m <
|
| * h</i> or if <i>m > 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 =
|
| @@ -4441,9 +4502,9 @@ class StaticWarningCode extends ErrorCode {
|
| * <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',
|
| @@ -4453,8 +4514,9 @@ class StaticWarningCode extends ErrorCode {
|
| * 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',
|
| @@ -4464,8 +4526,9 @@ class StaticWarningCode extends ErrorCode {
|
| * 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',
|
| @@ -4505,7 +4568,8 @@ class StaticWarningCode extends ErrorCode {
|
| * 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',
|
| @@ -4523,8 +4587,9 @@ class StaticWarningCode extends ErrorCode {
|
| * 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',
|
| @@ -4564,7 +4629,8 @@ class StaticWarningCode extends ErrorCode {
|
| * a<sub>n+1</sub>, … 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}'");
|
| @@ -4581,9 +4647,9 @@ class StaticWarningCode extends ErrorCode {
|
| * <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',
|
| @@ -4596,7 +4662,8 @@ class StaticWarningCode extends ErrorCode {
|
| * 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}'");
|
| @@ -4607,7 +4674,8 @@ class StaticWarningCode extends ErrorCode {
|
| * {<i>p<sub>n+1</sub></i> … <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',
|
| @@ -4624,9 +4692,9 @@ class StaticWarningCode extends ErrorCode {
|
| * 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',
|
| @@ -4636,9 +4704,9 @@ class StaticWarningCode extends ErrorCode {
|
| * 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',
|
| @@ -4649,9 +4717,9 @@ class StaticWarningCode extends ErrorCode {
|
| * <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',
|
| @@ -4668,9 +4736,9 @@ class StaticWarningCode extends ErrorCode {
|
| * 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',
|
| @@ -4700,7 +4768,8 @@ class StaticWarningCode extends ErrorCode {
|
| }
|
|
|
| /**
|
| - * 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 {
|
| /**
|
|
|
Chromium Code Reviews
Issue 990793002:
Clean up comments in error support (Closed)
Base URL: https://dart.googlecode.com/svn/branches/bleeding_edge/dart