Decorate the Document IDL with spec names

Source/core/dom/Document.idl

 /*
  * Copyright (C) 2006, 2007, 2011 Apple Inc. All rights reserved.
  * Copyright (C) 2006, 2007 Samuel Weinig <sam@webkit.org>
  *
  * This library is free software; you can redistribute it and/or
  * modify it under the terms of the GNU Library General Public
  * License as published by the Free Software Foundation; either
  * version 2 of the License, or (at your option) any later version.
  *
  * This library is distributed in the hope that it will be useful,
@@ skipping 66 matching lines @@
 
     // FIXME: CDATASection has been removed from the spec. crbug.com/437205
     [RaisesException, MeasureAs=DocumentCreateCDATASection] CDATASection createCDATASection(DOMString data);
 
     // FIXME: xmlEncoding/xmlVersion/xmlStandalone have been removed from the spec.
     [MeasureAs=DocumentXMLEncoding] readonly attribute DOMString? xmlEncoding;
     [RaisesException=Setter, MeasureAs=DocumentXMLVersion] attribute DOMString? xmlVersion;
     [RaisesException=Setter, MeasureAs=DocumentXMLStandalone] attribute boolean xmlStandalone;
 
     // https://dom.spec.whatwg.org/#interface-nonelementparentnode
-
     [PerWorldBindings] Element? getElementById(DOMString elementId);
 
+    // HTML
     // https://html.spec.whatwg.org/#the-document-object
 
     // resource metadata management
     [PutForwards=href, Unforgeable] readonly attribute Location? location;
     // FIXME: domain should not have [TreatNullAs=NullString].
     [TreatNullAs=NullString, RaisesException=Setter] attribute DOMString domain;
     readonly attribute DOMString referrer;
     // FIXME: cookie should not have [TreatNullAs=NullString].
     [TreatNullAs=NullString, RaisesException] attribute DOMString cookie;
     readonly attribute DOMString lastModified;
@@ skipping 29 matching lines @@
     boolean queryCommandEnabled(DOMString commandId);
     boolean queryCommandIndeterm(DOMString commandId);
     boolean queryCommandState(DOMString commandId);
     boolean queryCommandSupported(DOMString commandId);
     DOMString queryCommandValue(DOMString commandId);
 
     // special event handler IDL attributes that only apply to Document objects
     // FIXME: onreadystatechange should use [LenientThis].
     attribute EventHandler onreadystatechange;
 
+    // HTML obsolete features
     // https://html.spec.whatwg.org/#Document-partial
 
     // FIXME: *Color are on HTMLDocument.
 
     readonly attribute HTMLCollection anchors;
     readonly attribute HTMLCollection applets;
 
     // FIXME: clear(), captureEvents(), releaseEvents() and all are on HTMLDocument.
 
+    // CSS Object Model (CSSOM)
     // http://dev.w3.org/csswg/cssom/#extensions-to-the-document-interface
     readonly attribute StyleSheetList styleSheets;
     attribute DOMString? selectedStylesheetSet;
     readonly attribute DOMString? preferredStylesheetSet;
 
+    // CSSOM View Module
     // http://dev.w3.org/csswg/cssom-view/#extensions-to-the-document-interface
     // FIXME: The x and y arguments should be of type double.
     Element? elementFromPoint(long x, long y);
     sequence<Element> elementsFromPoint(long x, long y);
 
+    // Selection API
     // http://w3c.github.io/selection-api/#extensions-to-document-interface
     Selection? getSelection();
 
+    // Pointer Lock
     // https://dvcs.w3.org/hg/pointerlock/raw-file/default/index.html#extensions-to-the-document-interface
     attribute EventHandler onpointerlockchange;
     attribute EventHandler onpointerlockerror;
     [MeasureAs=DocumentPointerLockElement] readonly attribute Element? pointerLockElement;
     [MeasureAs=DocumentExitPointerLock] void exitPointerLock();
 
+    // Touch Events
     // http://www.w3.org/TR/touch-events/#extensions-to-the-document-interface
     // FIXME: The arguments should not be optional.
     // FIXME: The webkit-prefixed arguments are not in the spec.
     [RuntimeEnabled=Touch] Touch createTouch([Default=Undefined] optional Window window,
                                              [Default=Undefined] optional EventTarget target,
                                              [Default=Undefined] optional long identifier,
                                              [Default=Undefined] optional unrestricted double pageX,
                                              [Default=Undefined] optional unrestricted double pageY,
                                              [Default=Undefined] optional unrestricted double screenX,
                                              [Default=Undefined] optional unrestricted double screenY,
                                              [Default=Undefined] optional unrestricted double webkitRadiusX,
                                              [Default=Undefined] optional unrestricted double webkitRadiusY,
                                              [Default=Undefined] optional unrestricted float webkitRotationAngle,
                                              [Default=Undefined] optional unrestricted float webkitForce);
     [RuntimeEnabled=Touch] TouchList createTouchList(Touch... touches);
 
     // FIXME: The spec doesn't define these event handler attributes.
     [RuntimeEnabled=Touch] attribute EventHandler ontouchstart;
     [RuntimeEnabled=Touch] attribute EventHandler ontouchend;
     [RuntimeEnabled=Touch] attribute EventHandler ontouchmove;
     [RuntimeEnabled=Touch] attribute EventHandler ontouchcancel;
 
+    // Custom Elements
     // http://w3c.github.io/webcomponents/spec/custom/#extensions-to-document-interface-to-register
     // FIXME: The registerElement return type should be Function.
     [CallWith=ScriptState, CustomElementCallbacks, RaisesException, MeasureAs=DocumentRegisterElement] CustomElementConstructor registerElement(DOMString type, optional ElementRegistrationOptions options);
-
     // http://w3c.github.io/webcomponents/spec/custom/#extensions-to-document-interface-to-instantiate
     // FIXME: The typeExtension arguments should not be nullable.
     [CustomElementCallbacks, PerWorldBindings, RaisesException] Element createElement(DOMString localName, DOMString? typeExtension);
     [CustomElementCallbacks, RaisesException] Element createElementNS(DOMString? namespaceURI, DOMString qualifiedName, DOMString? typeExtension);
 
+    // Page Visibility
     // http://www.w3.org/TR/page-visibility/#sec-document-interface
     readonly attribute boolean hidden;
     readonly attribute VisibilityState visibilityState;
 
     // Non-standard APIs
     [MeasureAs=DocumentGetOverrideStyle] CSSStyleDeclaration getOverrideStyle();
     [MeasureAs=DocumentCharset, TreatReturnedNullStringAs=Undefined, TreatNullAs=NullString] attribute DOMString charset;
     [MeasureAs=DocumentDefaultCharset, TreatReturnedNullStringAs=Undefined] readonly attribute DOMString defaultCharset;
     [MeasureAs=DocumentCaretRangeFromPoint] Range caretRangeFromPoint([Default=Undefined] optional long x, [Default=Undefined] optional long y);
     [MeasureAs=DocumentGetCSSCanvasContext] RenderingContext getCSSCanvasContext(DOMString contextId, DOMString name, long width, long height);
@@ skipping 13 matching lines @@
     attribute EventHandler onpaste;
     attribute EventHandler onsearch;
     [RuntimeEnabled=ExperimentalContentSecurityPolicyFeatures] attribute EventHandler onsecuritypolicyviolation;
     attribute EventHandler onselectionchange;
     attribute EventHandler onselectstart;
     attribute EventHandler onwheel;
 };
 
 Document implements GlobalEventHandlers;
 Document implements ParentNode;