Change /// @docsEditable to @DocsEditable annotation.

tools/dom/scripts/htmldartgenerator.py

 #!/usr/bin/python
 # 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.
 
 """This module provides shared functionality for the system to generate
 dart:html APIs from the IDL database."""
 
 from generator import AnalyzeOperation, ConstantOutputOrder, \
     DartDomNameOfAttribute, FindMatchingAttribute, IsDartCollectionType, \
@@ skipping 19 matching lines @@
     self._renamer = options.renamer
 
   def EmitSupportCheck(self):
     if self.HasSupportCheck():
       support_check = self.GetSupportCheck()
       self._members_emitter.Emit('\n'
           '  /// Checks if this type is supported on the current platform.\n'
           '  static bool get supported => $SUPPORT_CHECK;\n',
           SUPPORT_CHECK=support_check)
 
-  def EmitAttributeDocumentation(self, attribute):
-    """ Emits the MDN dartdoc comment for an attribute.
-    """
-
-    dom_name = DartDomNameOfAttribute(attribute)
-
-    annotations = FindCommonAnnotations(dom_name)
-    annotations_str = ''
-    if annotations:
-      annotations_str = '\n' + '\n'.join(annotations)
-    self._members_emitter.Emit('\n  /// @docsEditable true',
-        DOMINTERFACE=attribute.doc_js_interface_name,
-        ANNOTATIONS=annotations)
-
-  def EmitOperationDocumentation(self, operation):
-    """ Emits the MDN dartdoc comment for an operation.
-    """
-
-    annotations = FindCommonAnnotations(operation.name)
-    annotations_str = ''
-    if annotations:
-      annotations_str = '\n' + '\n'.join(annotations)
-    self._members_emitter.Emit('\n  /// @docsEditable true',
-        DOMINTERFACE=operation.overloads[0].doc_js_interface_name,
-        ANNOTATIONS=annotations)
-
   def EmitEventGetter(self, events_class_name):
     self._members_emitter.Emit(
-        "\n  /// @docsEditable true"
+        "\n  @DocsEditable"
         "\n  @DomName('EventTarget.addEventListener, "
         "EventTarget.removeEventListener, EventTarget.dispatchEvent')"
         "\n  $TYPE get on =>\n    new $TYPE(this);\n",
         TYPE=events_class_name)
 
   def AddMembers(self, interface, declare_only=False):
     for const in sorted(interface.constants, ConstantOutputOrder):
       self.AddConstant(const)
 
     for attr in sorted(interface.attributes, ConstantOutputOrder):
@@ skipping 216 matching lines @@
           '\n'
           '  factory $CTOR.fromBuffer(ArrayBuffer buffer, '
               '[int byteOffset, int length]) => \n'
           '    $FACTORY.create$(CTOR)_fromBuffer(buffer, byteOffset, length);\n',
         CTOR=self._interface.id,
         TYPE=self._DartType(typed_array_type),
         FACTORY=factory_name)
 
   def _AddConstructor(self,
       constructor_info, factory_name, factory_constructor_name):
-    self._members_emitter.Emit('\n  /// @docsEditable true');
+    self._members_emitter.Emit('\n  @DocsEditable');
 
     if not factory_constructor_name:
       factory_constructor_name = '_create'
       factory_parameters = constructor_info.ParametersAsArgumentList()
       has_factory_provider = True
     else:
       factory_parameters = ', '.join(constructor_info.factory_parameters)
       has_factory_provider = False
 
     has_optional = any(param_info.is_optional
@@ skipping 51 matching lines @@
 
     if not constructor_info.pure_dart_constructor:
       self.EmitStaticFactory(constructor_info)
 
   def EmitHelpers(self, base_class):
     pass
 
   def DeclareAttribute(self, attribute, type_name, attr_name, read_only):
     """ Declares an attribute but does not include the code to invoke it.
     """
-    self.EmitAttributeDocumentation(attribute)
     if read_only:
       template = '\n  $TYPE get $NAME;\n'
     else:
       template = '\n  $TYPE $NAME;\n'
 
     self._members_emitter.Emit(template,
         NAME=attr_name,
         TYPE=type_name)
 
   def DeclareOperation(self, operation, return_type_name, method_name):
     """ Declares an operation but does not include the code to invoke it.
     Arguments:
       operation - The operation to be declared.
       return_type_name - The name of the return type.
       method_name - The name of the method.
     """
-    self.EmitOperationDocumentation(operation)
     self._members_emitter.Emit(
              '\n'
              '  $TYPE $NAME($PARAMS);\n',
              TYPE=return_type_name,
              NAME=method_name,
              PARAMS=operation.ParametersDeclaration(self._DartType))
 
   def EmitListMixin(self, element_name):
     # TODO(sra): Use separate mixins for mutable implementations of List<T>.
     # TODO(sra): Use separate mixins for typed array implementations of List<T>.
@@ skipping 66 matching lines @@
         walk(interface.parents)
       else:
         walk(interface.parents[1:])
     return result
 
   def _DartType(self, type_name):
     return self._type_registry.DartType(type_name)
 
   def _IsPrivate(self, name):
     return name.startswith('_')