changed NamedFlowCollection to snapshot

Author: astearns

css3-regions/Overview.html

@@ -38,13 +38,13 @@
 
    <h1 id=css-regions-module>CSS Regions Module Level 3</h1>
 
-   <h2 class="no-num no-toc" id=longstatus-date>Editor's Draft 11 August 2012</h2>
+   <h2 class="no-num no-toc" id=longstatus-date>Editor's Draft 16 August 2012</h2>
 
    <dl>
     <dt>This version:
 
     <dd><a
-     href="http://www.w3.org/TR/2012/ED-css3-regions-20120811/">http://www.w3.org/csswg/css3-regions</a>
+     href="http://www.w3.org/TR/2012/ED-css3-regions-20120816/">http://www.w3.org/csswg/css3-regions</a>
 
     <dt>Latest version:
 
@@ -1763,27 +1763,27 @@ <h3 id=the-namedflow-interface><span class=secno>6.1. </span>The NamedFlow
    href="#dom-named-flow"><code class=idl>NamedFlow</code></a> object
    representation of a <a href="#named-flow0">named flow</a>.
 
-  <p>An additional method and an additional attribute on the <a
+  <p>An additional method on the <a
    href="http://www.w3.org/TR/dom/#interface-document"><code
    class=idl>Document</code></a> interface provide access to <a
    href="#named-flow0">named flows</a>.
 
   <pre class=idl>
 partial interface <a
    href="http://www.w3.org/TR/dom/#interface-document">Document</a> {
-  readonly attribute <a
+  <a
    href="#dom-named-flow-collection">NamedFlowCollection</a> <a
-   href="#document-namedflows">namedFlows</a>;
+   href="#document-getnamedflows">getNamedFlows()</a>;
 };               
 </pre>
 
-  <p>The <dfn id=document-namedflows><code class=idl>namedFlows</code></dfn>
-   attribute on the <a
+  <p>The <dfn id=document-getnamedflows><code
+   class=idl>getNamedFlows()</code></dfn> method on the <a
    href="http://www.w3.org/TR/dom/#interface-document"><code
-   class=idl>Document</code></a> interface returns the live list of all the
-   current <a href="#named-flow0">named flows</a> in the document.
+   class=idl>Document</code></a> interface returns a static snapshot of all
+   the current <a href="#named-flow0">named flows</a> in the document.
 
-  <p>The <a href="#document-namedflows"><code class=idl>namedFlows</code></a>
+  <p>The <a href="#dom-named-flow"><code class=idl>namedFlows</code></a>
    collection must include all <a href="#named-flow0">named flows</a> that
    are currently in the <code>CREATED</code> state. The list must not include
    <a href="#named-flow0">named flows</a> that are in the <code>NULL</code>
@@ -1800,8 +1800,7 @@ <h3 id=the-namedflow-interface><span class=secno>6.1. </span>The NamedFlow
   <p>The <dfn id=dom-named-flow-collection><code
    class=idl>NamedFlowCollection</code></dfn> interface provides a list of
    current <a href="#dom-named-flow"><code class=idl>NamedFlow</code></a>
-   instances in the document. The collection is live and methods operate on
-   the underlying data, not a snapshot of the data.
+   instances in the document. The collection is a snapshot of the data.
 
   <pre class=idl>
 interface NamedFlowCollection {
@@ -2818,6 +2817,8 @@ <h3 id="changes_from_May_03_2012"><span class=secno>12.1. </span>Changes
    3<sup>rd</sup> 2012</a> version</h3>
 
   <ul>
+   <li>Changed NamedFlowCollection from live to a static snapshot
+
    <li>Changed NamedFlow to inherit from EventTarget
 
    <li>Removed flowFrom from Region interface and changed method name to
@@ -2888,8 +2889,9 @@ <h3 id="changes_from_November_29_2011"><span class=secno>12.2.
    <li>Added a name property to the <a
     href="#dom-named-flow"><code>NamedFlow</code></a> interface. Added a <a
     href="#dom-named-flow-collection"><code>NamedFlowCollection</code></a>
-    interface and added a <code>getNamedFlows</code> method on the
-    <code>Document</code> interface, as per <a
+    interface and added a <a
+    href="#document-getnamedflows"><code>getNamedFlows</code></a> method on
+    the <code>Document</code> interface, as per <a
     href="https://www.w3.org/Bugs/Public/show_bug.cgi?id=15828">Bug
     15828</a>.
 
@@ -3594,6 +3596,10 @@ <h2 class=no-num id=index>Index</h2>
    <li>getContent(), <a href="#dom-named-flow-get-content"
     title="getContent()"><strong>6.1.</strong></a>
 
+   <li><a href="#document-getnamedflows"><code
+    class=idl>getNamedFlows()</code></a>, <a href="#document-getnamedflows"
+    title="getNamedFlows()"><strong>6.1.</strong></a>
+
    <li>getRegionFlowRanges, <a href="#dom-region-getregionflowranges"
     title=getRegionFlowRanges><strong>6.2.</strong></a>
 
@@ -3633,10 +3639,6 @@ <h2 class=no-num id=index>Index</h2>
     href="#dom-named-flow-collection"
     title=NamedFlowCollection><strong>6.1.</strong></a>
 
-   <li><a href="#document-namedflows"><code class=idl>namedFlows</code></a>,
-    <a href="#document-namedflows" title=namedFlows><strong>6.1.</strong></a>
-    
-
    <li><a href="#dom-named-flow-collection-named-item"><code
     class=idl>namedItem(name)</code></a>, <a
     href="#dom-named-flow-collection-named-item"

css3-regions/Overview.src.html

@@ -1590,20 +1590,20 @@ <h3 id="the-namedflow-interface">The NamedFlow interface</h3>
         scripts to reference a <code class="idl">NamedFlow</code> object representation
         of a <span>named flow</span>.</p>
 
-    <p>An additional method and an additional attribute on the <a href=
+    <p>An additional method on the <a href=
     "http://www.w3.org/TR/dom/#interface-document"><code class=
     "idl">Document</code></a> interface provide access to <span>named flows</span>.</p>
 
     <pre class="idl">
 partial interface <a href=
 "http://www.w3.org/TR/dom/#interface-document">Document</a> {
-  readonly attribute <a href="#dom-named-flow-collection">NamedFlowCollection</a> <a href="#document-namedflows">namedFlows</a>;
+  <a href="#dom-named-flow-collection">NamedFlowCollection</a> <a href="#document-getnamedflows">getNamedFlows()</a>;
 };               
 </pre>
 
-    <p>The <dfn id="document-namedflows"><code class="idl">namedFlows</code></dfn> attribute on the <a href=
+    <p>The <dfn id="document-getnamedflows"><code class="idl">getNamedFlows()</code></dfn> method on the <a href=
     "http://www.w3.org/TR/dom/#interface-document"><code class=
-    "idl">Document</code></a> interface returns the live list of all the current <span>named
+    "idl">Document</code></a> interface returns a static snapshot of all the current <span>named
     flows</span> in the document. </p>
 
     <p>The <code class="idl">namedFlows</code> collection must include all <span>named flows</span> 
@@ -1617,10 +1617,12 @@ <h3 id="the-namedflow-interface">The NamedFlow interface</h3>
     </ul>
 
 
-    <p>The <dfn id="dom-named-flow-collection"><code class="idl">NamedFlowCollection</code></dfn>
-    interface provides a list of current <code class="idl">NamedFlow</code> instances in the 
-    document. The collection is live and methods operate on the underlying data, not a snapshot of
-    the data.</p>
+    <p>The <dfn id="dom-named-flow-collection"><code class="idl">NamedFlowCollection</code></dfn> 
+    interface provides a list of current 
+    <code class="idl">NamedFlow</code> instances 
+    in the document. 
+    The collection is 
+    a snapshot of the data.</p>
 
     <pre class="idl">
 interface NamedFlowCollection {
@@ -2445,6 +2447,7 @@ <h2 id="changes">Changes</h2>
     <h3 id="changes_from_May_03_2012">Changes from <a href="http://www.w3.org/TR/2012/WD-css3-regions-20120503/">May 3<sup>rd</sup> 2012</a> version</h3>
 
     <ul>
+      <li>Changed NamedFlowCollection from live to a static snapshot</li>
       <li>Changed NamedFlow to inherit from EventTarget</li>
       <li>Removed flowFrom from Region interface and changed method name to getComputedRegionStyle().</li>
       <li>Region interface is now a supplemental interface with the [NoInterfaceObject] extended attribute.</li>