Make html metadata follow the spec.

tools/dom/scripts/dartmetadata.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 to provide Dart metadata for
 DOM APIs.
 """
 
 import copy
@@ skipping 281 matching lines @@
     ],
 
     'XMLHttpRequest.response': [
       "@Creates('ByteBuffer|Blob|Document|=Object|JSExtendableArray|String"
                 "|num')",
     ],
 }, dart2jsOnly=True)
 
 _blink_experimental_annotations = [
   "@SupportedBrowser(SupportedBrowser.CHROME)",
-  "@Experimental",
+  "@Experimental()",
 ]
 
 _indexed_db_annotations = [
   "@SupportedBrowser(SupportedBrowser.CHROME)",
   "@SupportedBrowser(SupportedBrowser.FIREFOX, '15')",
   "@SupportedBrowser(SupportedBrowser.IE, '10')",
-  "@Experimental",
+  "@Experimental()",
 ]
 
 _file_system_annotations = [
   "@SupportedBrowser(SupportedBrowser.CHROME)",
-  "@Experimental",
+  "@Experimental()",
 ]
 
 _all_but_ie9_annotations = [
   "@SupportedBrowser(SupportedBrowser.CHROME)",
   "@SupportedBrowser(SupportedBrowser.FIREFOX)",
   "@SupportedBrowser(SupportedBrowser.IE, '10')",
   "@SupportedBrowser(SupportedBrowser.SAFARI)",
 ]
 
 _history_annotations = _all_but_ie9_annotations
 
 _no_ie_annotations = [
   "@SupportedBrowser(SupportedBrowser.CHROME)",
   "@SupportedBrowser(SupportedBrowser.FIREFOX)",
   "@SupportedBrowser(SupportedBrowser.SAFARI)",
 ]
 
 _performance_annotations = [
   "@SupportedBrowser(SupportedBrowser.CHROME)",
   "@SupportedBrowser(SupportedBrowser.FIREFOX)",
   "@SupportedBrowser(SupportedBrowser.IE)",
 ]
 
 _rtc_annotations = [ # Note: Firefox nightly builds also support this.
   "@SupportedBrowser(SupportedBrowser.CHROME)",
-  "@Experimental",
+  "@Experimental()",
 ]
 
 _shadow_dom_annotations = [
   "@SupportedBrowser(SupportedBrowser.CHROME, '26')",
-  "@Experimental",
+  "@Experimental()",
 ]
 
 _speech_recognition_annotations = [
   "@SupportedBrowser(SupportedBrowser.CHROME, '25')",
-  "@Experimental",
+  "@Experimental()",
 ]
 
 _svg_annotations = _all_but_ie9_annotations;
 
 _web_sql_annotations = [
   "@SupportedBrowser(SupportedBrowser.CHROME)",
   "@SupportedBrowser(SupportedBrowser.SAFARI)",
-  "@Experimental",
+  "@Experimental()",
 ]
 
 _webgl_annotations = [
   "@SupportedBrowser(SupportedBrowser.CHROME)",
   "@SupportedBrowser(SupportedBrowser.FIREFOX)",
-  "@Experimental",
+  "@Experimental()",
 ]
 
 _webkit_experimental_annotations = [
   "@SupportedBrowser(SupportedBrowser.CHROME)",
   "@SupportedBrowser(SupportedBrowser.SAFARI)",
-  "@Experimental",
+  "@Experimental()",
 ]
 
 # Annotations to be placed on generated members.
 # The table is indexed as:
 #   INTERFACE:     annotations to be added to the interface declaration
 #   INTERFACE.MEMBER: annotation to be added to the member declaration
 _annotations = monitored.Dict('dartmetadata._annotations', {
   'CSSHostRule': _shadow_dom_annotations,
   'CSSMatrix': _webkit_experimental_annotations,
   'Crypto': _webkit_experimental_annotations,
@@ skipping 13 matching lines @@
   'DOMWindow.webkitConvertPointFromPageToNode': _webkit_experimental_annotations,
   'DOMWindow.indexedDB': _indexed_db_annotations,
   'DOMWindow.openDatabase': _web_sql_annotations,
   'DOMWindow.performance': _performance_annotations,
   'DOMWindow.webkitNotifications': _webkit_experimental_annotations,
   'DOMWindow.webkitRequestFileSystem': _file_system_annotations,
   'DOMWindow.webkitResolveLocalFileSystemURL': _file_system_annotations,
   'Element.ontransitionend': _all_but_ie9_annotations,
   # Placeholder to add experimental flag, implementation for this is
   # pending in a separate CL.
-  'Element.webkitMatchesSelector': ['@Experimental()'],
+  'Element.webkitMatchesSelector': ['@Experimental()()'],
   'Element.webkitCreateShadowRoot': [
     "@SupportedBrowser(SupportedBrowser.CHROME, '25')",
-    "@Experimental",
+    "@Experimental()",
   ],
   'Event.clipboardData': _webkit_experimental_annotations,
   'FormData': _all_but_ie9_annotations,
   'HashChangeEvent': [
     "@SupportedBrowser(SupportedBrowser.CHROME)",
     "@SupportedBrowser(SupportedBrowser.FIREFOX)",
     "@SupportedBrowser(SupportedBrowser.SAFARI)",
   ],
   'History.pushState': _history_annotations,
   'History.replaceState': _history_annotations,
@@ skipping 24 matching lines @@
   'IDBFactory': _indexed_db_annotations,
   'IDBDatabase': _indexed_db_annotations,
   'MediaStream': _rtc_annotations,
   'MediaStreamEvent': _rtc_annotations,
   'MediaStreamTrack': _rtc_annotations,
   'MediaStreamTrackEvent': _rtc_annotations,
   'MutationObserver': [
     "@SupportedBrowser(SupportedBrowser.CHROME)",
     "@SupportedBrowser(SupportedBrowser.FIREFOX)",
     "@SupportedBrowser(SupportedBrowser.SAFARI)",
-    "@Experimental",
+    "@Experimental()",
   ],
   'NotificationCenter': _webkit_experimental_annotations,
   'Performance': _performance_annotations,
   'PopStateEvent': _history_annotations,
   'RTCIceCandidate': _rtc_annotations,
   'RTCPeerConnection': _rtc_annotations,
   'RTCSessionDescription': _rtc_annotations,
   'ShadowRoot': _shadow_dom_annotations,
   'SpeechRecognition': _speech_recognition_annotations,
   'SpeechRecognitionAlternative': _speech_recognition_annotations,
@@ skipping 120 matching lines @@
       dom_name = '%s.%s' % (interface.javascript_binding_name, member_name)
     else:
       key = interface.id
       dom_name = interface.javascript_binding_name
 
     annotations = ["@DomName('" + dom_name + "')"]
 
     # Only add this for members, so we don't add DocsEditable to templated
     # classes (they get it from the default class template)
     if member_name:
-      annotations.append('@DocsEditable');
+      annotations.append('@DocsEditable()');
 
     if key in _annotations:
       annotations.extend(_annotations[key])
 
     if (not member_name and
         interface.javascript_binding_name.startswith('WebKit') and
         interface.id not in html_interface_renames):
       annotations.extend(_webkit_experimental_annotations)
 
     if (member_name and member_name.startswith('webkit') and
@@ skipping 106 matching lines @@
     support_level = support_info.get('support_level')
     comment = support_info.get('comment')
     annotations = []
     # TODO(blois): should add an annotation for the comment, but keeping out
     # to keep the initial diff a bit more localized.
     #if comment:
     #  annotations.append('// %s' % comment)
 
     if dart_action:
       if dart_action == 'unstable':
-        annotations.append('@Unstable')
+        annotations.append('@Unstable()')
       elif dart_action == 'experimental':
         if comment:
           annotations.append('// %s' % comment)
-        annotations.append('@Experimental // %s' % support_level)
+        annotations.append('@Experimental() // %s' % support_level)
       elif dart_action == 'suppress':
         if comment:
           annotations.append('// %s' % comment)
         annotations.append('@deprecated // %s' % support_level)
         # TODO (blois): suppress generation of these APIs as a separate CL.
         pass
       elif dart_action == 'stable':
         pass
       else:
         _logger.warn('Unknown dart_action - %s:%s' % (interface_id, member_id))
     elif support_level == 'untriaged':
-      annotations.append('@Experimental // untriaged')
+      annotations.append('@Experimental() // untriaged')
     elif support_level == 'experimental':
       if comment:
         annotations.append('// %s' % comment)
-      annotations.append('@Experimental')
+      annotations.append('@Experimental()')
     elif support_level == 'nonstandard':
       if comment:
         annotations.append('// %s' % comment)
-      annotations.append('@Experimental // non-standard')
+      annotations.append('@Experimental() // non-standard')
     elif support_level == 'stable':
       pass
     elif support_level == 'deprecated':
       if comment:
         annotations.append('// %s' % comment)
       annotations.append('@deprecated')
     elif support_level is None:
       pass
     else:
       _logger.warn('Unknown support_level - %s:%s' % (interface_id, member_id))
 
     return annotations
 
   def Flush(self):
     json_file = open(self._api_status_path, 'w+')
     json.dump(self._types, json_file, indent=2, separators=(',', ': '), sort_keys=True)
     json_file.close()