Rearrange the Document interfaces to match the many specs

Source/core/html/HTMLDocument.idl

 /*
  * Copyright (C) 2006, 2007, 2008 Apple Inc. All rights reserved.
  * Copyright (C) 2006 Samuel Weinig <sam.weinig@gmail.com>
  *
  * 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,
  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  * Library General Public License for more details.
  *
  * You should have received a copy of the GNU Library General Public License
  * along with this library; see the file COPYING.LIB.  If not, write to
  * the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
  * Boston, MA 02110-1301, USA.
  */
 
+// FIXME: "For historical reasons, Window objects must also have a
+// writable, configurable, non-enumerable property named HTMLDocument
+// whose value is the Document interface object."
+// https://html.spec.whatwg.org/#the-window-object
+
 interface HTMLDocument : Document {
+    // FIXME: This shadows the compatMode on the Document interface.
+    readonly attribute DOMString compatMode;
+
+    // https://html.spec.whatwg.org/#the-document-object
+
+    // dynamic markup insertion
+    // FIXME: There are two open() methods in the spec.
     [Custom, CustomElementCallbacks] void open();
     [RaisesException] void close();
-
-    // We support multiple DOMString arguments to match FF / IE, e.g.:
-    // document.write("a", "b", "c") --> document.write("abc")
-    // document.write() --> document.write("")
     [CallWith=ActiveWindow, CustomElementCallbacks, RaisesException] void write(DOMString... text);
     [CallWith=ActiveWindow, CustomElementCallbacks, RaisesException] void writeln(DOMString... text);
 
-    // Extensions
+    // https://html.spec.whatwg.org/#Document-partial
 
-    [Replaceable, ImplementedAs=allForBinding] readonly attribute HTMLAllCollection all;
+    // FIXME: *Color should have [TreatNullAs=EmptyString].
+    [TreatNullAs=NullString, CustomElementCallbacks] attribute DOMString fgColor;
+    [TreatNullAs=NullString, CustomElementCallbacks] attribute DOMString linkColor;
+    [TreatNullAs=NullString, CustomElementCallbacks] attribute DOMString vlinkColor;
+    [TreatNullAs=NullString, CustomElementCallbacks] attribute DOMString alinkColor;
+    [TreatNullAs=NullString, CustomElementCallbacks] attribute DOMString bgColor;
 
     [MeasureAs=DocumentClear] void clear();
-
     [MeasureAs=DocumentCaptureEvents] void captureEvents();
     [MeasureAs=DocumentReleaseEvents] void releaseEvents();
 
-    readonly attribute DOMString compatMode;
-
-    // Deprecated attributes
-    [TreatNullAs=NullString, CustomElementCallbacks] attribute DOMString bgColor;
-    [TreatNullAs=NullString, CustomElementCallbacks] attribute DOMString fgColor;
-    [TreatNullAs=NullString, CustomElementCallbacks] attribute DOMString alinkColor;
-    [TreatNullAs=NullString, CustomElementCallbacks] attribute DOMString linkColor;
-    [TreatNullAs=NullString, CustomElementCallbacks] attribute DOMString vlinkColor;
+    // FIXME: all should not be [Replaceable].
+    [Replaceable, ImplementedAs=allForBinding] readonly attribute HTMLAllCollection all;
 };
-