Add support for documentation comments to most of AstBuilder.

pkg/analyzer/test/generated/parser_fasta_test.dart

 // Copyright (c) 2017, 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/dart/ast/token.dart' as analyzer;
 import 'package:analyzer/dart/element/element.dart';
 import 'package:analyzer/error/error.dart';
 import 'package:analyzer/src/generated/parser.dart' as analyzer;
 import 'package:analyzer/src/generated/utilities_dart.dart';
@@ skipping 115 matching lines @@
     // TODO(paulberry): Unhandled event: ThisExpression
     super.test_parseConstructorFieldInitializer_qualified();
   }
 
   @override
   @failingTest
   void test_parseConstructorFieldInitializer_unqualified() {
     // TODO(paulberry): Expected: an object with length of <1>
     super.test_parseConstructorFieldInitializer_unqualified();
   }
-
-  @override
-  @failingTest
-  void test_parseGetter_nonStatic() {
-    // TODO(paulberry): handle doc comments
-    super.test_parseGetter_nonStatic();
-  }
-
-  @override
-  @failingTest
-  void test_parseGetter_static() {
-    // TODO(paulberry): Invalid modifier (static). Report an error.
-    super.test_parseGetter_static();
-  }
-
-  @override
-  @failingTest
-  void test_parseInitializedIdentifierList_type() {
-    // TODO(paulberry): handle doc comments
-    super.test_parseInitializedIdentifierList_type();
-  }
-
-  @override
-  @failingTest
-  void test_parseInitializedIdentifierList_var() {
-    // TODO(paulberry): handle doc comments
-    super.test_parseInitializedIdentifierList_var();
-  }
-
-  @override
-  @failingTest
-  void test_parseOperator() {
-    // TODO(paulberry): handle doc comments
-    super.test_parseOperator();
-  }
-
-  @override
-  @failingTest
-  void test_parseSetter_nonStatic() {
-    // TODO(paulberry): handle doc comments
-    super.test_parseSetter_nonStatic();
-  }
-
-  @override
-  @failingTest
-  void test_parseSetter_static() {
-    // TODO(paulberry): Invalid modifier (static). Report an error.
-    super.test_parseSetter_static();
-  }
 }
 
 /**
  * Tests of the fasta parser based on [ComplexParserTestMixin].
  */
 @reflectiveTest
 class ComplexParserTest_Fasta extends FastaParserTestCase
     with ComplexParserTestMixin {
   @override
   @failingTest
@@ skipping 406 matching lines @@
     fail('Not implemented');
   }
 
   @override
   void assertNoErrors() {
     // TODO(paulberry): implement assertNoErrors
   }
 
   @override
   void createParser(String content) {
-    var scanner = new StringScanner(content);
+    var scanner = new StringScanner(content, includeComments: true);
     _parserProxy = new ParserProxy(scanner.tokenize());
   }
 
   @override
   Expression parseAdditiveExpression(String code) {
     return _parseExpression(code);
   }
 
   @override
   Expression parseAssignableExpression(String code, bool primaryAllowed) {
@@ skipping 581 matching lines @@
   void test_parseDirectives_mixed() {
     // TODO(paulberry,ahe): This test verifies the analyzer parser's ability to
     // stop parsing as soon as the first non-directive is encountered; this is
     // useful for quickly traversing an import graph.  Consider adding a similar
     // ability to Fasta's parser.
     super.test_parseDirectives_mixed();
   }
 
   @override
   @failingTest
-  void test_parseFunctionDeclaration_function() {
-    // TODO(paulberry): handle doc comments
-    super.test_parseFunctionDeclaration_function();
-  }
-
-  @override
-  @failingTest
-  void test_parseFunctionDeclaration_functionWithTypeParameters() {
-    // TODO(paulberry): handle doc comments
-    super.test_parseFunctionDeclaration_functionWithTypeParameters();
-  }
-
-  @override
-  @failingTest
   void test_parseFunctionDeclaration_functionWithTypeParameters_comment() {
     // TODO(paulberry,ahe): generic method comment syntax is not supported by
     // Fasta.
     super.test_parseFunctionDeclaration_functionWithTypeParameters_comment();
   }
 
   @override
   @failingTest
-  void test_parseFunctionDeclaration_getter() {
-    // TODO(paulberry): handle doc comments
-    super.test_parseFunctionDeclaration_getter();
-  }
-
-  @override
-  @failingTest
-  void test_parseFunctionDeclaration_setter() {
-    // TODO(paulberry): handle doc comments
-    super.test_parseFunctionDeclaration_setter();
-  }
-
-  @override
-  @failingTest
   void test_parsePartOfDirective_name() {
     // TODO(paulberry,ahe): Thes test verifies that even if URIs in "part of"
     // declarations are enabled, a construct of the form "part of identifier;"
     // is still properly handled.  URIs in "part of" declarations are not
     // supported by Fasta yet.
     super.test_parsePartOfDirective_name();
   }
 
   @override
   @failingTest
   void test_parsePartOfDirective_uri() {
     // TODO(paulberry,ahe): URIs in "part of" declarations are not supported by
     // Fasta.
     super.test_parsePartOfDirective_uri();
   }
 }