adding details to Region interface

Author: astearns

css3-regions/Overview.html

@@ -2100,23 +2100,25 @@ <h3 id=the-region-interface><span class=secno>6.2. </span>The Region
    Region</span>.
 
   <div class=note>
-   <p>A <a href="#css-region"><code class=idl>Region</code></a> instance may
-    represent an object that is no longer a <a href="#css-region">region</a>.
-    This may happen, for example if the ‘<a href="#flow-from"><code
-    class=property>flow-from</code></a>’ property on the corresponding
-    pseudo-element, element or other construct becomes ‘<code
-    class=property>none</code>’ but a script is still holding a reference
-    to the <a href="#css-region"><code class=idl>Region</code></a> object.</p>
+   <p>If the element is not contained in the <span>CSS Region</span> at all,
+    the method returns the <a href="#the-at-region-style-rule">region
+    styling</a> that would apply to the element if it were contained in the
+    CSS Region (following how <a
+    href="http://dev.w3.org/csswg/cssom/#dom-window-getcomputedstyle"><code
+    class=idl>getComputedStyle</code></a> works with elements not contained
+    in the window's document).</p>
   </div>
 
-  <p>If a <a href="#css-region"><code class=idl>Region</code></a> instance is
-   no longer a <a href="#css-region">region</a>, accessing its attributes (<a
-   href="#dom-region-regionoverset"><code class=idl>regionOverset</code></a>
-   and <a href="#dom-region-flowfrom"><code class=idl>flowFrom</code></a>) or
-   invoking its <a href="#dom-region-getregionflowranges"><code
-   class=idl><span
-   title="#document-element-getregionflowranges">getRegionFlowRanges</span></code></a>
-   method throws a <a
+  <p>A <a href="#css-region"><code class=idl>Region</code></a> instance may
+   represent an object that is no longer a <a href="#css-region">region</a>.
+   This may happen for example if the ‘<a href="#flow-from"><code
+   class=property>flow-from</code></a>’ property on the corresponding
+   pseudo-element, element or other construct becomes ‘<code
+   class=property>none</code>’ but a script is still holding a reference to
+   the <a href="#css-region"><code class=idl>Region</code></a> object. If a
+   <a href="#css-region"><code class=idl>Region</code></a> instance is no
+   longer a <a href="#css-region">region</a>, accessing its attributes or
+   invoking its methods throws a <a
    href="http://www.w3.org/TR/dom/#exception-domexception"><code
    class=idl>DOMException</code></a> with the <a
    href="http://www.w3.org/TR/dom/#dom-domexception-invalid_access_err"><code

css3-regions/Overview.src.html

@@ -1884,21 +1884,38 @@ <h3 id="the-region-interface">The Region interface</h3>
           If the element is fragmented across region boundaries, 
           the <a href="http://dev.w3.org/csswg/cssom/#cssstyledeclaration">CSSStyleDeclaration</a>  returned must apply only 
           to the fragment that flows through 
-          the <span>CSS Region</span>.
+          the <span>CSS Region</span>.</p>
 
         <div class="note">
-            <p>A <code class="idl">Region</code> instance may represent an 
-            object that is no longer a <span>region</span>. This may happen, for example if the 
-            'flow-from' property on the corresponding pseudo-element, element or other construct 
-            becomes 'none' but a script is still holding a reference to the <code class="idl">Region</code> object.</p>
+          <p>If the element is not contained 
+          in the <span>CSS Region</span> at all, 
+          the method returns 
+          the <a href="#the-at-region-style-rule">region styling</a> 
+          that would apply to the element 
+          if it were contained in the CSS Region 
+          (following how <a href="http://dev.w3.org/csswg/cssom/#dom-window-getcomputedstyle"><code class="idl">getComputedStyle</code></a> works 
+          with elements not contained 
+          in the window's document).</p>
         </div>
-        
-        <p>If a <code class="idl">Region</code> instance is no longer a <span>region</span>, 
-            accessing its attributes (<code class="idl">regionOverset</code> and <code class="idl">flowFrom</code>) or
-            invoking its <code class=
-        "idl"><span title="#document-element-getregionflowranges">getRegionFlowRanges</span></code>
-        method throws a <a href="http://www.w3.org/TR/dom/#exception-domexception"><code class="idl">DOMException</code></a> with the 
-        <a href="http://www.w3.org/TR/dom/#dom-domexception-invalid_access_err"><code class="idl">INVALID_ACCESS_ERR</code></a> error code.</p>  
+
+        <p>A <code class="idl">Region</code> instance 
+          may represent an object 
+          that is no longer a <span>region</span>. 
+          This may happen for example 
+          if the 'flow-from' property 
+          on the corresponding pseudo-element, 
+          element or other construct
+          becomes 'none' 
+          but a script is still holding 
+          a reference to the <code class="idl">Region</code> object. 
+          If a <code class="idl">Region</code> instance 
+          is no longer a <span>region</span>, 
+          accessing its attributes 
+          or invoking its methods throws a 
+          <a href="http://www.w3.org/TR/dom/#exception-domexception"><code class="idl">DOMException</code></a> 
+          with the 
+          <a href="http://www.w3.org/TR/dom/#dom-domexception-invalid_access_err"><code class="idl">INVALID_ACCESS_ERR</code></a> 
+          error code.</p>
         </div>
 
     <h3 id="region-style-rule-interface">The CSSRegionStyleRule interface</h3>