Support experimental annotations for the analysis server spec.

pkg/analysis_server/tool/spec/from_html.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.
 
 /**
  * Code for reading an HTML API description.
  */
 import 'dart:io';
 
 import 'package:analyzer/src/codegen/html.dart';
@@ skipping 113 matching lines @@
     element.attributes.forEach((String name, String value) {
       if (!requiredAttributes.contains(name) &&
           !optionalAttributes.contains(name)) {
         throw new Exception(
             '$context: Unexpected attribute in ${element.localName}: $name');
       }
       attributesFound.add(name);
     });
     for (String expectedAttribute in requiredAttributes) {
       if (!attributesFound.contains(expectedAttribute)) {
-        throw new Exception(
-            '$context: ${element.localName} must contain attribute $expectedAttribute');
+        throw new Exception('$context: ${element
+            .localName} must contain attribute $expectedAttribute');
       }
     }
   }
 
   /**
    * Check that the given [element] has the given [expectedName].
    */
   void checkName(dom.Element element, String expectedName, [String context]) {
     if (element.localName != expectedName) {
       if (context == null) {
@@ skipping 58 matching lines @@
    *
    * <params> has the same form as <object>, as described in [typeDeclFromHtml].
    *
    * Child elements can occur in any order.
    */
   Notification notificationFromHtml(dom.Element html, String context) {
     String domainName = getAncestor(html, 'domain', context).attributes['name'];
     checkName(html, 'notification', context);
     String event = html.attributes['event'];
     context = '$context.${event != null ? event : 'event'}';
-    checkAttributes(html, ['event'], context);
+    checkAttributes(html, ['event'], context,
+        optionalAttributes: ['experimental']);
+    bool experimental = html.attributes['experimental'] == 'true';
     TypeDecl params;
     recurse(html, context, {
       'params': (dom.Element child) {
         params = typeObjectFromHtml(child, '$context.params');
       }
     });
-    return new Notification(domainName, event, params, html);
+    return new Notification(domainName, event, params, html,
+        experimental: experimental);
   }
 
   /**
    * Create a single of [TypeDecl] corresponding to the type defined inside the
    * given HTML element.
    */
   TypeDecl processContentsAsType(dom.Element html, String context) {
     List<TypeDecl> types = processContentsAsTypes(html, context);
     if (types.length != 1) {
       throw new Exception('$context: Exactly one type must be specified');
@@ skipping 365 matching lines @@
       }
     });
     for (dom.Element element in childElements) {
       html.append(element);
     }
     Types types = new Types(typeMap, html);
     types.importUris.addAll(importUris);
     return types;
   }
 }