Merge pull request #186 from w3c/zcorpan/revert-kill-domrectlist

Revert "Kill DOMRectList"

Author: tabatkins

geometry/Overview.bs

@@ -410,6 +410,29 @@ steps:
 </div>
 
 
+<h2 id=DOMRectList>The DOMRectList interface</h2>
+
+<pre class=idl>
+[NoInterfaceObject,
+ LegacyArrayClass]
+interface DOMRectList {
+    readonly attribute unsigned long length;
+    getter DOMRect? item(unsigned long index);
+};
+</pre>
+
+The <dfn dfn-type=attribute dfn-for=DOMRectList>length</dfn> attribute must return the total
+number of {{DOMRect}} objects associated with the object.
+
+The <dfn dfn-type=method dfn-for=DOMRectList>item(<var>index</var>)</dfn> method, when invoked, must
+return ''null'' when <var>index</var> is greater than or equal to the number of {{DOMRect}} objects
+associated with the {{DOMRectList}}. Otherwise, the {{DOMRect}} object at <var>index</var> must be
+returned. Indices are zero-based.
+
+ADVISEMENT: {{DOMRectList}} only exists for compatibility with legacy Web content. When specifying a
+new API, {{DOMRectList}} must not be used. Use <code>sequence&lt;DOMRect></code> instead. [[WEBIDL]]
+
+
 <h2 id=DOMQuad>The DOMQuad interface</h2>
 
 <p>Objects implementing the {{DOMQuad}} interface represents a <dfn>quadrilateral</dfn>.
@@ -2121,8 +2144,6 @@ href="https://www.w3.org/TR/2014/WD-geometry-1-20140918/">18 September 2014 Work
 
  <li><p>Introduced the {{DOMMatrixInit}} dictionary.
 
- <li><p>Removed the <code>DOMRectList</code> interface.
-
  <li><p>Added JSON serializers for the interfaces.
 
  <li>
@@ -2176,9 +2197,10 @@ Draft</a>.
 
  <li><p>{{DOMMatrixReadOnly}} got a constructor taking a sequence of numbers as argument.
 
- <li><p>DOMRectList turned to an ArrayClass. The interfaces can just be used for legacy interfaces.
+ <li><p>{{DOMRectList}} turned to an ArrayClass. The interfaces can just be used for legacy
+ interfaces.
 
- <li><p>Put DOMRectList on at-Risk awaiting browser feedback.
+ <li><p>Put {{DOMRectList}} on at-Risk awaiting browser feedback.
 
  <li><p>All interfaces are described in the sense of internal elements to describe the
  read-only/writable and inheriting behavior.