Simplified and clarified the NamedFlow states and behavior when no longer in created state

Author: vhardy

css3-regions/Overview.html

@@ -228,13 +228,13 @@
 
    <h1 id=css-regions-module>CSS Regions Module Level 3</h1>
 
-   <h2 class="no-num no-toc" id=longstatus-date>Editor's Draft 16 April 2012</h2>
+   <h2 class="no-num no-toc" id=longstatus-date>Editor's Draft 20 April 2012</h2>
 
    <dl>
     <dt>This version:
 
     <dd><a
-     href="http://www.w3.org/TR/2012/ED-css3-regions-20120416/">http://www.w3.org/csswg/css3-regions</a>
+     href="http://www.w3.org/TR/2012/ED-css3-regions-20120420/">http://www.w3.org/csswg/css3-regions</a>
 
     <dt>Latest version:
 
@@ -1932,17 +1932,7 @@ <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>The possible states for a <a href="#named-flow0">named flow</a> are
-   described in the following figure. These states are referenced in
-   subsequent text.
-
-  <div class=figure> <img alt="NamedFlow states"
-   src="images/named-flow-states.svg" width=600px>
-   <p class=caption><a href="#named-flow0">named flow</a> states and
-    transitions</p>
-  </div>
-
-  <p>An addition method and attribute on the <a
+  <p>An additional method and an additional attribute 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>.
@@ -1967,11 +1957,9 @@ <h3 id=the-namedflow-interface><span class=secno>6.1. </span>The NamedFlow
 
   <p>The <a href="#document-namedflows"><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> and
-   <code>CREATED-REFERENCED</code> states. The list may include <a
-   href="#named-flow0">named flows</a> that are in the
-   <code>REFERENCED</code> state. The list may also include <a
-   href="#named-flow0">named flows</a> that are in the STALE state.
+   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>
+   state.
 
   <p>The <dfn id=document-getflowbyname><code
    class=idl>getFlowByName</code></dfn> method on the <a
@@ -1985,25 +1973,8 @@ <h3 id=the-namedflow-interface><span class=secno>6.1. </span>The NamedFlow
    <li><code class=idl>NULL</code>: the user agent must return
     <code>null</code>.
 
-   <li><code class=idl>STALE</code>: the user agent may return null or a
-    valid <a href="#dom-named-flow"><code class=idl>NamedFlow</code></a>
-    instance. If the user agent returns a valid instance, subsequent calls to
-    the <a href="#document-getflowbyname"><code
-    class=idl>getFlowByName</code></a> method for the same name argument must
-    return the same object instance, no matter what the state of the <a
-    href="#named-flow0">named flow</a> is.
-
-   <li><code class=idl>CREATED</code> or <code
-    class=idl>CREATED-REFERENCED</code>: the user agent must return a valid
-    <a href="#dom-named-flow"><code class=idl>NamedFlow</code></a> instance.
-
-   <li><code class=idl>REFERENCED</code>: the user agent may return
-    <code>null</code> or it may return a valid <a
-    href="#dom-named-flow"><code class=idl>NamedFlow</code></a> instance. If
-    the user agent returns a valid object, subsequent calls to the <a
-    href="#document-getflowbyname"><code class=idl>getFlowByName</code></a>
-    method with the same name argument must return the same object instance,
-    no matter what the state of the <a href="#named-flow0">named flow</a> is.
+   <li><code class=idl>CREATED</code>: the user agent must return a valid <a
+    href="#dom-named-flow"><code class=idl>NamedFlow</code></a> instance.
   </ul>
 
   <p>The <dfn id=dom-named-flow-collection><code
@@ -2035,12 +2006,20 @@ <h3 id=the-namedflow-interface><span class=secno>6.1. </span>The NamedFlow
    collection.length</code>.
 
   <p>The <dfn id=dom-named-flow><code class=idl>NamedFlow</code></dfn>
-   interface offers a representation of the <a href="#named-flow0">named
-   flow</a>. A <a href="#dom-named-flow"><code class=idl>NamedFlow</code></a>
-   object is live meaning that it always represents the <a
-   href="#named-flow0">named flow</a> with the corresponding name, even if
-   that <a href="#named-flow0">named flow</a> has transitioned to the
-   <code>REFERENCED</code> or the <code>STALE</code> states.
+   interface offers a representation of a <a href="#named-flow0">named
+   flow</a> instance.
+
+  <p>The <a href="#dom-named-flow"><code class=idl>NamedFlow</code></a>
+   interface can be used for different purposes. For example, the <a
+   href="#dom-named-flow-get-regions-by-content"><code>getRegionsByContent()</code></a>
+   method can help navigate by bookmark: a script can find the <a
+   href="#css-region">region</a>s that display a particular anchor and bring
+   them to view.
+
+  <p>Likewise, the interface allows authors to check if all content has been
+   fitted into existing regions. If it has, the <a
+   href="#dom-named-flow-overset"><code>overset</code></a> attribute would be
+   false.
 
   <pre class=idl>
 interface <a
@@ -2108,17 +2087,54 @@ <h3 id=the-namedflow-interface><span class=secno>6.1. </span>The NamedFlow
    target content node. Note that the returned values is a static sequence in
    document order.
 
-  <p>The <a href="#dom-named-flow"><code class=idl>NamedFlow</code></a>
-   interface can be used for different purposes. For example, the <a
-   href="#dom-named-flow-get-regions-by-content"><code>getRegionsByContent()</code></a>
-   method can help navigate by bookmark: a script can find the <a
-   href="#css-region">region</a>s that display a particular anchor and bring
-   them to view.
+  <p>The <a href="#named-flow0">named flow</a> states are :
 
-  <p>Likewise, the interface allows authors to check if all content has been
-   fitted into existing regions. If it has, the <a
-   href="#dom-named-flow-overset"><code>overset</code></a> attribute would be
-   false.
+  <ul>
+   <li><code class=idl>NULL</code>: the <a href="#named-flow0">named flow</a>
+    is not referenced by any &lsquo;<a href="#flow-into"><code
+    class=property>flow-into</code></a>&rsquo; or &lsquo;<a
+    href="#flow-from"><code class=property>flow-from</code></a>&rsquo;
+    computed value.
+
+   <li><code class=idl>CREATED</code>: the <a href="#named-flow0">named
+    flow</a> is referenced by at least one &lsquo;<a href="#flow-into"><code
+    class=property>flow-into</code></a>&rsquo; or &lsquo;<a
+    href="#flow-from"><code class=property>flow-from</code></a>&rsquo;
+    computed value.
+  </ul>
+
+  <p>A <a href="#dom-named-flow"><code class=idl>NamedFlow</code></a> object
+   is live: it always represents the <a href="#named-flow0">named flow</a>
+   with the corresponding name even if that <a href="#named-flow0">named
+   flow</a> has transitioned to the <code>NULL</code> state.
+
+  <p>If a script holds a reference to a <a href="#dom-named-flow"><code
+   class=idl>NamedFlow</code></a> instance that has entered the
+   <code>NULL</code> state, its attributes and methods should behave as
+   follows:
+
+  <ul>
+   <li>the <a href="#dom-named-flow-name"><code class=idl>name</code></a>
+    attribute returns its value as normal.
+
+   <li>the <a href="#dom-named-flow-overset"><code
+    class=idl>overset</code></a> attribute returns <code
+    class=idl>true</code>.
+
+   <li>the <a href="#dom-named-flow-get-regions"><code
+    class=idl>getRegions</code></a> method returns an empty sequence.
+
+   <li>the <a href="#dom-named-flow-first-empty-region-index"><code
+    class=idl>firstEmptyRegionIndex</code></a> attribute returns <code
+    class=idl>-1</code>.
+
+   <li>the <a href="#dom-named-flow-get-content"><code
+    class=idl>getContent()</code></a> method returns an empty <code
+    class=idl>NodeList</code> instance.
+
+   <li>the <code class=idl>getRegionsByContentNode()</code> method retuns an
+    empty sequence.
+  </ul>
 
   <h3 id=the-region-interface><span class=secno>6.2. </span>The Region
    interface</h3>