Mark not-optional-parameters methods of AstFactory as deprecated.

pkg/analyzer/lib/dart/ast/ast_factory.dart

 // Copyright (c) 2016, the Dart project authors.  Please see the AUTHORS file
 // for details. All rights reserved. Use of this source code is governed by a
 // BSD-style license that can be found in the LICENSE file.
 
 import 'package:analyzer/dart/ast/ast.dart';
 import 'package:analyzer/src/generated/utilities_dart.dart';
 import 'package:front_end/src/scanner/token.dart';
 import 'package:meta/meta.dart';
 
 /**
@@ skipping 65 matching lines @@
   /**
    * Returns a newly created await expression.
    */
   AwaitExpression awaitExpression(Token awaitKeyword, Expression expression);
 
   /**
    * Returns a newly created binary expression.
    */
   BinaryExpression binaryExpression(
       Expression leftOperand, Token operator, Expression rightOperand);
+
   /**
    * Returns a newly created block of code.
    */
   Block block(
       Token leftBracket, List<Statement> statements, Token rightBracket);
 
   /**
    * Returns a block comment consisting of the given [tokens].
    */
   Comment blockComment(List<Token> tokens);
@@ skipping 304 matching lines @@
   /**
    * Returns a newly created extends clause.
    */
   ExtendsClause extendsClause(Token extendsKeyword, TypeName superclass);
 
   /**
    * Returns a newly created field declaration. Either or both of the
    * [comment] and [metadata] can be `null` if the declaration does not have the
    * corresponding attribute. The [staticKeyword] can be `null` if the field is
    * not a static field.
+   *
+   * Use [fieldDeclaration2] instead.
    */
+  @deprecated
   FieldDeclaration fieldDeclaration(Comment comment, List<Annotation> metadata,
       Token staticKeyword, VariableDeclarationList fieldList, Token semicolon);
 
   /**
    * Returns a newly created field declaration. Either or both of the
    * [comment] and [metadata] can be `null` if the declaration does not have the
    * corresponding attribute. The [staticKeyword] can be `null` if the field is
    * not a static field.
    */
   FieldDeclaration fieldDeclaration2(
       {Comment comment,
       List<Annotation> metadata,
       Token covariantKeyword,
       Token staticKeyword,
       @required VariableDeclarationList fieldList,
       @required Token semicolon});
 
   /**
    * Returns a newly created formal parameter. Either or both of the
    * [comment] and [metadata] can be `null` if the parameter does not have the
    * corresponding attribute. The [keyword] can be `null` if there is a type.
    * The [type] must be `null` if the keyword is 'var'. The [thisKeyword] and
    * [period] can be `null` if the keyword 'this' was not provided.  The
    * [parameters] can be `null` if this is not a function-typed field formal
    * parameter.
+   *
+   * Use [fieldFormalParameter2] instead.
    */
+  @deprecated
   FieldFormalParameter fieldFormalParameter(
       Comment comment,
       List<Annotation> metadata,
       Token keyword,
       TypeAnnotation type,
       Token thisKeyword,
       Token period,
       SimpleIdentifier identifier,
       TypeParameterList typeParameters,
       FormalParameterList parameters);
@@ skipping 129 matching lines @@
       SimpleIdentifier name,
       TypeParameterList typeParameters,
       FormalParameterList parameters,
       Token semicolon);
 
   /**
    * Returns a newly created formal parameter. Either or both of the
    * [comment] and [metadata] can be `null` if the parameter does not have the
    * corresponding attribute. The [returnType] can be `null` if no return type
    * was specified.
+   *
+   * Use [functionTypedFormalParameter2] instead.
    */
+  @deprecated
   FunctionTypedFormalParameter functionTypedFormalParameter(
       Comment comment,
       List<Annotation> metadata,
       TypeAnnotation returnType,
       SimpleIdentifier identifier,
       TypeParameterList typeParameters,
       FormalParameterList parameters,
       {Token question: null});
 
   /**
@@ skipping 317 matching lines @@
    * Returns a newly created import show combinator.
    */
   ShowCombinator showCombinator(
       Token keyword, List<SimpleIdentifier> shownNames);
 
   /**
    * Returns a newly created formal parameter. Either or both of the
    * [comment] and [metadata] can be `null` if the parameter does not have the
    * corresponding attribute. The [keyword] can be `null` if a type was
    * specified. The [type] must be `null` if the keyword is 'var'.
+   *
+   * Use [simpleFormalParameter2] instead.
    */
+  @deprecated
   SimpleFormalParameter simpleFormalParameter(
       Comment comment,
       List<Annotation> metadata,
       Token keyword,
       TypeAnnotation type,
       SimpleIdentifier identifier);
 
   /**
    * Returns a newly created formal parameter. Either or both of the
    * [comment] and [metadata] can be `null` if the parameter does not have the
@@ skipping 166 matching lines @@
    */
   WithClause withClause(Token withKeyword, List<TypeName> mixinTypes);
 
   /**
    * Returns a newly created yield expression. The [star] can be `null` if no
    * star was provided.
    */
   YieldStatement yieldStatement(
       Token yieldKeyword, Token star, Expression expression, Token semicolon);
 }