updates to the analysis server generated spec doc

pkg/analyzer_plugin/tool/spec/from_html.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.
 
 /**
  * Code for reading an HTML API description.
  */
 import 'dart:io';
 
 import 'package:analyzer/src/codegen/html.dart';
@@ skipping 375 matching lines @@
  * [typeDeclFromHtml].
  *
  * Child elements can occur in any order.
  */
 Request requestFromHtml(dom.Element html, String context) {
   String domainName = getAncestor(html, 'domain', context).attributes['name'];
   checkName(html, 'request', context);
   String method = html.attributes['method'];
   context = '$context.${method != null ? method : 'method'}';
   checkAttributes(html, ['method'], context,
-      optionalAttributes: ['experimental']);
+      optionalAttributes: ['experimental', 'deprecated']);
   bool experimental = html.attributes['experimental'] == 'true';
+  bool deprecated = html.attributes['deprecated'] == 'true';
   TypeDecl params;
   TypeDecl result;
   recurse(html, context, {
     'params': (dom.Element child) {
       params = typeObjectFromHtml(child, '$context.params');
     },
     'result': (dom.Element child) {
       result = typeObjectFromHtml(child, '$context.result');
     }
   });
   return new Request(domainName, method, params, result, html,
-      experimental: experimental);
+      experimental: experimental, deprecated: deprecated);
 }
 
 /**
  * Create a [TypeDefinition] object from an HTML representation such as:
  *
  * <type name="typeName">
  *   TYPE
  * </type>
  *
  * Where TYPE is any HTML that can be parsed by [typeDeclFromHtml].
  *
  * Child elements can occur in any order.
  */
 TypeDefinition typeDefinitionFromHtml(dom.Element html) {
   checkName(html, 'type');
   String name = html.attributes['name'];
   String context = name != null ? name : 'type';
   checkAttributes(html, ['name'], context,
-      optionalAttributes: ['experimental']);
+      optionalAttributes: ['experimental', 'deprecated']);
   TypeDecl type = processContentsAsType(html, context);
   bool experimental = html.attributes['experimental'] == 'true';
-  return new TypeDefinition(name, type, html, experimental: experimental);
+  bool deprecated = html.attributes['deprecated'] == 'true';
+  return new TypeDefinition(name, type, html,
+      experimental: experimental, deprecated: deprecated);
 }
 
 /**
  * Create a [TypeEnum] from an HTML description.
  */
 TypeEnum typeEnumFromHtml(dom.Element html, String context) {
   checkName(html, 'enum', context);
   checkAttributes(html, [], context);
   List<TypeEnumValue> values = <TypeEnumValue>[];
   recurse(html, context, {
@@ skipping 10 matching lines @@
  * <enum>
  *   <code>VALUE</code>
  * </enum>
  *
  * Where VALUE is the text of the enumerated value.
  *
  * Child elements can occur in any order.
  */
 TypeEnumValue typeEnumValueFromHtml(dom.Element html, String context) {
   checkName(html, 'value', context);
-  checkAttributes(html, [], context);
+  checkAttributes(html, [], context, optionalAttributes: ['deprecated']);
+  bool deprecated = html.attributes['deprecated'] == 'true';
   List<String> values = <String>[];
   recurse(html, context, {
     'code': (dom.Element child) {
       String text = innerText(child).trim();
       values.add(text);
     }
   });
   if (values.length != 1) {
     throw new Exception('$context: Exactly one value must be specified');
   }
-  return new TypeEnumValue(values[0], html);
+  return new TypeEnumValue(values[0], html, deprecated: deprecated);
 }
 
 /**
  * Create a [TypeObjectField] from an HTML description such as:
  *
  * <field name="fieldName">
  *   TYPE
  * </field>
  *
  * Where TYPE is any HTML that can be parsed by [typeDeclFromHtml].
  *
  * In addition, the attribute optional="true" may be used to specify that the
  * field is optional, and the attribute value="..." may be used to specify that
  * the field is required to have a certain value.
  *
  * Child elements can occur in any order.
  */
 TypeObjectField typeObjectFieldFromHtml(dom.Element html, String context) {
   checkName(html, 'field', context);
   String name = html.attributes['name'];
   context = '$context.${name != null ? name : 'field'}';
   checkAttributes(html, ['name'], context,
-      optionalAttributes: ['optional', 'value']);
+      optionalAttributes: ['optional', 'value', 'deprecated']);
+  bool deprecated = html.attributes['deprecated'] == 'true';
   bool optional = false;
   String optionalString = html.attributes['optional'];
   if (optionalString != null) {
     switch (optionalString) {
       case 'true':
         optional = true;
         break;
       case 'false':
         optional = false;
         break;
       default:
         throw new Exception(
             '$context: field contains invalid "optional" attribute: "$optionalString"');
     }
   }
   String value = html.attributes['value'];
   TypeDecl type = processContentsAsType(html, context);
   return new TypeObjectField(name, type, html,
-      optional: optional, value: value);
+      optional: optional, value: value, deprecated: deprecated);
 }
 
 /**
  * Create a [TypeObject] from an HTML description.
  */
 TypeObject typeObjectFromHtml(dom.Element html, String context) {
   checkAttributes(html, [], context, optionalAttributes: ['experimental']);
   List<TypeObjectField> fields = <TypeObjectField>[];
   recurse(html, context, {
     'field': (dom.Element child) {
@@ skipping 21 matching lines @@
       TypeDefinition typeDefinition = typeDefinitionFromHtml(child);
       types[typeDefinition.name] = typeDefinition;
     }
   });
   return new Types(types, html);
 }
 
 typedef void ElementProcessor(dom.Element element);
 
 typedef void TextProcessor(dom.Text text);