Rename xFunctionBody to xBlockFunctionBody. Document related listener methods.

pkg/front_end/lib/src/fasta/parser/parser.dart

 // Copyright (c) 2012, the Dart project authors.  Please see the AUTHORS file
 // for details. All rights reserved. Use of this source code is governed by a
 // BSD-style license that can be found in the LICENSE file.
 
 library fasta.parser.parser;
 
 import '../scanner.dart' show ErrorToken;
 
 import '../scanner/recover.dart' show closeBraceFor, skipToEof;
 
@@ skipping 2023 matching lines @@
       }
     }
     return token;
   }
 
   Token parseFunctionBody(Token token, bool isExpression, bool allowAbstract) {
     if (optional(';', token)) {
       if (!allowAbstract) {
         reportRecoverableError(token, ErrorKind.ExpectedBody);
       }
-      listener.endEmptyFunctionBody(token);
+      listener.handleEmptyFunctionBody(token);
       return token;
     } else if (optional('=>', token)) {
       Token begin = token;
       token = parseExpression(token.next);
       if (!isExpression) {
         expectSemicolon(token);
-        listener.endExpressionFunctionBody(begin, token);
+        listener.handleExpressionFunctionBody(begin, token);
       } else {
-        listener.endExpressionFunctionBody(begin, null);
+        listener.handleExpressionFunctionBody(begin, null);
       }
       return token;
     } else if (optional('=', token)) {
       Token begin = token;
       // Recover from a bad factory method.
       reportRecoverableError(token, ErrorKind.ExpectedBody);
       token = parseExpression(token.next);
       if (!isExpression) {
         expectSemicolon(token);
-        listener.endExpressionFunctionBody(begin, token);
+        listener.handleExpressionFunctionBody(begin, token);
       } else {
-        listener.endExpressionFunctionBody(begin, null);
+        listener.handleExpressionFunctionBody(begin, null);
       }
       return token;
     }
     Token begin = token;
     int statementCount = 0;
     if (!optional('{', token)) {
       token =
           reportUnrecoverableError(token, ErrorKind.ExpectedFunctionBody)?.next;
       listener.handleInvalidFunctionBody(token);
       return token;
     }
 
-    listener.beginFunctionBody(begin);
+    listener.beginBlockFunctionBody(begin);
     token = token.next;
     while (notEofOrValue('}', token)) {
       token = parseStatement(token);
       ++statementCount;
     }
-    listener.endFunctionBody(statementCount, begin, token);
+    listener.endBlockFunctionBody(statementCount, begin, token);
     expect('}', token);
     return token;
   }
 
   Token skipAsyncModifier(Token token) {
     String value = token.stringValue;
     if (identical(value, 'async')) {
       token = token.next;
       value = token.stringValue;
 
@@ skipping 1502 matching lines @@
         break;
     }
     if (isRecoverable) {
       listener.handleRecoverableError(token, kind, arguments);
       return null;
     } else {
       return listener.handleUnrecoverableError(token, kind, arguments);
     }
   }
 }