Issue 25385. Set documentation comment for enum constants.

pkg/analyzer/lib/src/generated/utilities_dart.dart

 // Copyright (c) 2014, 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 analyzer.src.generated.utilities_dart;
 
+import 'package:analyzer/dart/ast/ast.dart' show AnnotatedNode, Comment;
+import 'package:analyzer/dart/ast/token.dart' show Token;
+import 'package:analyzer/src/generated/element.dart' show ElementImpl;
 import 'package:analyzer/src/generated/java_core.dart';
 
 /**
+ * If the given [node] has a documentation comment, remember its content
+ * and range into the given [element].
+ */
+void setElementDocumentationComment(ElementImpl element, AnnotatedNode node) {
+  Comment comment = node.documentationComment;
+  if (comment != null && comment.isDocumentation) {
+    element.documentationComment =
+        comment.tokens.map((Token t) => t.lexeme).join('\n');
+    element.setDocRange(comment.offset, comment.length);
+  }
+}
+
+/**
  * Check whether [uri1] starts with (or 'is prefixed by') [uri2] by checking
  * path segments.
  */
 bool startsWith(Uri uri1, Uri uri2) {
   List<String> uri1Segments = uri1.pathSegments;
   List<String> uri2Segments = uri2.pathSegments.toList();
   // Punt if empty (https://github.com/dart-lang/sdk/issues/24126)
   if (uri2Segments.isEmpty) {
     return false;
   }
@@ skipping 36 matching lines @@
   final bool isOptional;
 
   /**
    * Initialize a newly created kind with the given state.
    *
    * @param isOptional `true` if this is an optional parameter
    */
   const ParameterKind(String name, int ordinal, this.isOptional)
       : super(name, ordinal);
 }