Add documentation comments for enum and enum values. Resynthesize in analyzer.

pkg/front_end/lib/src/fasta/source/outline_builder.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.
 
 library fasta.outline_builder;
 
 import 'package:kernel/ast.dart' show ProcedureKind;
 
 import '../../scanner/token.dart' show Token;
 
@@ skipping 182 matching lines @@
   void handleOperatorName(Token operatorKeyword, Token token) {
     debugEvent("OperatorName");
     push(operatorFromString(token.stringValue));
     push(token.charOffset);
   }
 
   @override
   void handleIdentifier(Token token, IdentifierContext context) {
     super.handleIdentifier(token, context);
     push(token.charOffset);
+    if (context == IdentifierContext.enumValueDeclaration) {
+      String documentationComment = _getDocumentationComment(token);
+      push(documentationComment ?? NullValue.DocumentationComment);
+    }
   }
 
   @override
   void handleNoName(Token token) {
     super.handleNoName(token);
     push(token.charOffset);
   }
 
   @override
   void endLiteralString(int interpolationCount, Token endToken) {
@@ skipping 406 matching lines @@
   }
 
   @override
   void handleNoFormalParameters(Token token, MemberKind kind) {
     push(token.charOffset);
     super.handleNoFormalParameters(token, kind);
   }
 
   @override
   void endEnum(Token enumKeyword, Token endBrace, int count) {
-    List constantNamesAndOffsets = popList(count * 2);
+    String documentationComment = _getDocumentationComment(enumKeyword);
+    List constantNamesAndOffsets = popList(count * 3);
     int charOffset = pop();
     String name = pop();
     List<MetadataBuilder> metadata = pop();
-    library.addEnum(metadata, name, constantNamesAndOffsets, charOffset,
-        endBrace.charOffset);
+    library.addEnum(documentationComment, metadata, name,
+        constantNamesAndOffsets, charOffset, endBrace.charOffset);
     checkEmpty(enumKeyword.charOffset);
   }
 
   @override
   void beginFunctionTypeAlias(Token token) {
     library.beginNestedDeclaration("#typedef", hasMembers: false);
     silenceParserErrors = false;
   }
 
   @override
@@ skipping 271 matching lines @@
   }
 
   @override
   Link<Token> handleMemberName(Link<Token> identifiers) {
     if (!enableNative || identifiers.isEmpty) return identifiers;
     return removeNativeClause(identifiers, stringExpectedAfterNative);
   }
 
   /// Return the documentation comment for the entity that starts at the
   /// given [token], or `null` if there is no preceding documentation comment.
-  String _getDocumentationComment(Token token) {
+  static String _getDocumentationComment(Token token) {
     Token docToken = token.precedingComments;
     if (docToken == null) return null;
     bool inSlash = false;
     var buffer = new StringBuffer();
     while (docToken != null) {
       String lexeme = docToken.lexeme;
       if (lexeme.startsWith('/**')) {
         inSlash = false;
         buffer.clear();
         buffer.write(lexeme);
@@ skipping 10 matching lines @@
       docToken = docToken.next;
     }
     return buffer.toString();
   }
 
   @override
   void debugEvent(String name) {
     // printEvent(name);
   }
 }