Added all issue references to Bugzilla. Added proposal to address https://www.w3.org/Bugs/Public/show_bug.cgi?id=15828

Author: vhardy

css3-regions/Overview.html

@@ -55,7 +55,7 @@
              display: none;
          }
 
-         @media screen and (min-width: 58em){
+         @media screen and (min-width: 68em){
                   .issue-marker {
                       position: absolute;
                       width: 20ex;
@@ -64,7 +64,7 @@
                   }
          }
 
-         @media screen and (max-width: 58em){
+         @media screen and (max-width: 68em){
                   .issue-marker {
                   }
 
@@ -126,14 +126,14 @@
 
    <h1 id=css-regions-module>CSS Regions Module Level 3</h1>
 
-   <h2 class="no-num no-toc" id=longstatus-date>Editor's Draft 31 January
+   <h2 class="no-num no-toc" id=longstatus-date>Editor's Draft 1 February
     2012</h2>
 
    <dl>
     <dt>This version:
 
     <dd><a
-     href="http://www.w3.org/TR/2012/ED-css3-regions-20120131/">http://www.w3.org/csswg/css3-regions</a>
+     href="http://www.w3.org/TR/2012/ED-css3-regions-20120201/">http://www.w3.org/csswg/css3-regions</a>
 
     <dt>Latest version:
 
@@ -901,6 +901,15 @@ <h3 id=the-flow-from-property><span class=secno>4.2. </span>The &lsquo;<a
    <div class=issue-details>
     <p class=short-desc>Should regions be non-breakable?</p>
    </div>
+   <a href="https://www.w3.org/Bugs/Public/show_bug.cgi?15824">Bug-15824</a>
+   <div class=issue-details>
+    <p class=short-desc>Should regions not create a new stacking context?</p>
+   </div>
+   <a href="https://www.w3.org/Bugs/Public/show_bug.cgi?15824">Bug-15827</a>
+   <div class=issue-details>
+    <p class=short-desc>Specify behavior of stacking contexts that are split
+     between regions</p>
+   </div>
   </div>
 
   <p><span title=region>Regions</span> create a new <a
@@ -1009,7 +1018,7 @@ <h3 id=region-flow-break><span class=secno>4.3. </span>Region flow break
   <table class=propdef summary="break-before property definition">
    <tbody>
     <tr>
-     <td><em>Name:</em>
+     <td><a href="#dom-namedflow-name"><em>Name:</em></a>
 
      <td><dfn id=break-before>break-before</dfn>
 
@@ -1053,7 +1062,7 @@ <h3 id=region-flow-break><span class=secno>4.3. </span>Region flow break
   <table class=propdef summary="break-after property definition">
    <tbody>
     <tr>
-     <td><em>Name:</em>
+     <td><a href="#dom-namedflow-name"><em>Name:</em></a>
 
      <td><dfn id=break-after>break-after</dfn>
 
@@ -1097,7 +1106,7 @@ <h3 id=region-flow-break><span class=secno>4.3. </span>Region flow break
   <table class=propdef summary="break-inside property definition">
    <tbody>
     <tr>
-     <td><em>Name:</em>
+     <td><a href="#dom-namedflow-name"><em>Name:</em></a>
 
      <td><dfn id=break-inside>break-inside</dfn>
 
@@ -1164,7 +1173,7 @@ <h3 id=the-region-overflow-property><span class=secno>4.4. </span>The
   <table class=propdef summary="break-after property definition">
    <tbody>
     <tr>
-     <td><em>Name:</em>
+     <td><a href="#dom-namedflow-name"><em>Name:</em></a>
 
      <td><dfn id=region-overflow>region-overflow</dfn>
 
@@ -1639,26 +1648,72 @@ <h3 id=the-namedflow-interface><span class=secno>6.1. </span>The NamedFlow
    </div>
   </div>
 
-  <p>The <code class=idl>getFlowByName</code> method on the <a
+  <p>Supplemental methods on the <a
    href="http://www.w3.org/TR/DOM-Level-3-Core/core.html#i-Document"><code
-   class=idl>Document</code></a> interface provides access to the document's
-   <a href="#named-flow0">named flow</a> instances.
+   class=idl>Document</code></a> interface provide access to named flows.
 
   <pre class=idl>
 [Supplemental] interface <a
    href="http://www.w3.org/TR/DOM-Level-3-Core/core.html#i-Document">Document</a> {
   <a
    href="#dom-namedflow">NamedFlow</a> getFlowByName(<a
    href="http://www.w3.org/TR/DOM-Level-3-Core/core.html#DOMString">DOMString</a> name);
+  <a
+   href="#dom-namedflow-collection">NamedFlowCollection</a> getNamedFlows();
 };               
 </pre>
 
+  <p>The <code class=idl>getNamedFlows</code> method on the <a
+   href="http://www.w3.org/TR/DOM-Level-3-Core/core.html#i-Document"><code
+   class=idl>Document</code></a> interface returns the list of all the <a
+   href="#named-flow0">named flow</a>s in the document.
+
+  <p>The <code class=idl>getFlowByName</code> method on the <a
+   href="http://www.w3.org/TR/DOM-Level-3-Core/core.html#i-Document"><code
+   class=idl>Document</code></a> interface provides access to the document's
+   <a href="#named-flow0">named flow</a> instances.
+
+  <div class=issue-marker> <a
+   href="https://www.w3.org/Bugs/Public/show_bug.cgi?15828">Bug-15828</a>
+   <div class=issue-details>
+    <p class=short-desc>Should add a &lsquo;<a
+     href="#dom-namedflow-name"><code class=property>name</code></a>&rsquo;
+     property on NamedFlow and should have a Document method to get all
+     existing NamedFlow instances.</p>
+   </div>
+  </div>
+
+  <p>The <dfn id=dom-namedflow-collection><code
+   class=idl>NamedFlowCollection</code></dfn> interface provides a list of
+   current <a href="#dom-namedflow"><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.
+
+  <pre class=idl>
+interface NamedFlowCollection {
+    readonly attribute unsigned long length;
+    caller getter <a
+   href="#dom-namedflow">NamedFlow</a> item (in unsigned long index);
+}
+    </pre>
+
+  <p>The <dfn id=dom-namedflow-collection-length><code
+   class=idl>length</code></dfn> attribute value is the number of items in
+   the collection.
+
+  <p>The <dfn id=dom-namedflow-collection-item><code
+   class=idl>item(index)</code></dfn> method returns the item at index
+   <em>index</em> in the collection or <code class=idl>null</code> if
+   <em>index</em> is out of range.
+
   <p>The <dfn id=dom-namedflow><code class=idl>NamedFlow</code></dfn>
    interface offers a representation of the <a href="#named-flow0">named
    flow</a>.
 
   <pre class=idl>
 interface <a href="#dom-namedflow">NamedFlow</a> {
+  readonly attribute <a
+   href="http://www.w3.org/TR/DOM-Level-3-Core/core.html#DOMString">DOMString</a> name;
   readonly attribute boolean <a
    href="#dom-namedflow-overflow">overflow</a>;
   readonly attribute <a
@@ -1669,13 +1724,17 @@ <h3 id=the-namedflow-interface><span class=secno>6.1. </span>The NamedFlow
   };
 };</pre>
 
+  <p>The <dfn id=dom-namedflow-name><code class=idl>name</code></dfn>
+   attribute value is the name of the <a href="#dom-namedflow"><code
+   class=idl>NamedFlow</code></a> instance.
+
   <p>The <dfn id=dom-namedflow-overflow><code class=idl>overflow</code></dfn>
-   property is true if the named flow does not fully fit in the associated
-   regions. Otherwise, it is false. A <a href="#dom-namedflow"><code
-   class=idl>NamedFlow</code></a> object is live.
+   attribute value is true if the named flow does not fully fit in the
+   associated regions. Otherwise, it is false. A <a
+   href="#dom-namedflow"><code class=idl>NamedFlow</code></a> object is live.
 
-  <p>The <dfn id=dom-namedflow-contentnodes>contentNodes</dfn> property
-   returns an ordered collection of nodes that constitute the named flow.
+  <p>The <dfn id=dom-namedflow-contentnodes>contentNodes</dfn> attribute
+   value is an ordered collection of nodes that constitute the named flow.
    Note that this collection is live: every time it is queried it must return
    the same object, and the object is always up to date.
 
@@ -1924,6 +1983,14 @@ <h3 id="changes_from_June_09_2011"><span class=secno>10.1. </span>Changes
    <li>Clarified that the <code>NodeList</code> returned by <a
     href="#dom-namedflow-getregionsbycontentnodes"><code>getRegionsByContentNode</code></a>
     is live.
+
+   <li>Added a name property to the <a
+    href="#dom-namedflow"><code>NamedFlow</code></a> interface. Added a <a
+    href="#dom-namedflow-collection"><code>NamedFlowCollection</code></a>
+    interface and added a <code>getNamedFlows</code> 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>.
   </ul>
 
   <h3 id="changes_from_June_09_2011"><span class=secno>10.2. </span>Changes
@@ -2398,12 +2465,29 @@ <h2 class=no-num id=index>Index</h2>
     href="#dom-namedflow-getregionsbycontentnodes"
     title="getRegionsByContentNode()"><strong>6.1.</strong></a>
 
+   <li><a href="#dom-namedflow-collection-item"><code
+    class=idl>item(index)</code></a>, <a
+    href="#dom-namedflow-collection-item"
+    title="item(index)"><strong>6.1.</strong></a>
+
+   <li><a href="#dom-namedflow-collection-length"><code
+    class=idl>length</code></a>, <a href="#dom-namedflow-collection-length"
+    title=length><strong>6.1.</strong></a>
+
+   <li><a href="#dom-namedflow-name"><code class=idl>name</code></a>, <a
+    href="#dom-namedflow-name" title=name><strong>6.1.</strong></a>
+
    <li><a href="#dom-namedflow"><code class=idl>NamedFlow</code></a>, <a
     href="#dom-namedflow" title=NamedFlow><strong>6.1.</strong></a>
 
    <li>named flow, <a href="#named-flow0"
     title="named flow"><strong>2.2.</strong></a>
 
+   <li><a href="#dom-namedflow-collection"><code
+    class=idl>NamedFlowCollection</code></a>, <a
+    href="#dom-namedflow-collection"
+    title=NamedFlowCollection><strong>6.1.</strong></a>
+
    <li><a href="#dom-namedflow-overflow"><code class=idl>overflow</code></a>,
     <a href="#dom-namedflow-overflow"
     title=overflow><strong>6.1.</strong></a>

css3-regions/Overview.src.html

@@ -58,7 +58,7 @@
              display: none;
          }
 
-         @media screen and (min-width: 58em){
+         @media screen and (min-width: 68em){
                   .issue-marker {
                       position: absolute;
                       width: 20ex;
@@ -67,7 +67,7 @@
                   }
          }
 
-         @media screen and (max-width: 58em){
+         @media screen and (max-width: 68em){
                   .issue-marker {
                   }
 
@@ -733,7 +733,23 @@ <h3 id="the-flow-from-property">The 'flow-from' property</h3>
         <div class="issue-details">
             <p class="short-desc">Should regions be non-breakable?</p>
         </div>
-    </div>
+
+        <a href=
+        "https://www.w3.org/Bugs/Public/show_bug.cgi?15824">Bug-15824</a>
+
+        <div class="issue-details">
+            <p class="short-desc">Should regions not create a new stacking context?</p>
+        </div>    
+        
+        <a href=
+        "https://www.w3.org/Bugs/Public/show_bug.cgi?15824">Bug-15827</a>
+
+        <div class="issue-details">
+            <p class="short-desc">Specify behavior of stacking contexts that are split between regions</p>
+        </div>    
+        
+        
+        </div>
 
     <p><span title="region">Regions</span> create a new <a href="http://www.w3.org/TR/CSS2/visuren.html#z-index">stacking context</a>. <span title="region">Regions</span> establish a new <a href="http://www.w3.org/TR/CSS2/visuren.html#block-formatting">block formatting Context</a>.</p>
 
@@ -1431,34 +1447,79 @@ <h3 id="the-namedflow-interface">The NamedFlow interface</h3>
         </div>
     </div>
 
-    <p>The <code class="idl">getFlowByName</code> method on the <a href=
+    <p>Supplemental methods on the <a href=
     "http://www.w3.org/TR/DOM-Level-3-Core/core.html#i-Document"><code class=
-    "idl">Document</code></a> interface provides access to the document's <span
-    >named flow</span> instances.</p>
+    "idl">Document</code></a> interface provide access to named flows.</p>
+    
     <pre class="idl">
 [Supplemental] interface <a href=
 "http://www.w3.org/TR/DOM-Level-3-Core/core.html#i-Document">Document</a> {
   <a href="#dom-namedflow">NamedFlow</a> getFlowByName(<a href="http://www.w3.org/TR/DOM-Level-3-Core/core.html#DOMString">DOMString</a> name);
+  <a href="#dom-namedflow-collection">NamedFlowCollection</a> getNamedFlows();
 };               
 </pre>
 
+    <p>The <code class="idl">getNamedFlows</code> method on the <a href=
+    "http://www.w3.org/TR/DOM-Level-3-Core/core.html#i-Document"><code class=
+    "idl">Document</code></a> interface returns the list of all the <span>named
+    flow</span>s in the document.</p>
+    
+    <p>The <code class="idl">getFlowByName</code> method on the <a href=
+    "http://www.w3.org/TR/DOM-Level-3-Core/core.html#i-Document"><code class=
+    "idl">Document</code></a> interface provides access to the document's <span
+    >named flow</span> instances.</p>
+    
+
+    <div class="issue-marker">
+        <a href=
+        "https://www.w3.org/Bugs/Public/show_bug.cgi?15828">Bug-15828</a>
+
+        <div class="issue-details">
+            <p class="short-desc">Should add a 'name' property on NamedFlow and 
+                should have a Document method to get all existing NamedFlow instances.</p>
+        </div>
+    </div>
+
+    <p>The <dfn id="dom-namedflow-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>
+    
+    <pre class="idl">
+interface NamedFlowCollection {
+    readonly attribute unsigned long length;
+    caller getter <a href="#dom-namedflow">NamedFlow</a> item (in unsigned long index);
+}
+    </pre>
+    
+    <p>The <dfn id="dom-namedflow-collection-length"><code class="idl">length</code></dfn> 
+        attribute value is the number of items in the collection.</p>
+    <p>The <dfn id="dom-namedflow-collection-item"><code class="idl">item(index)</code></dfn> 
+        method returns the item at index <em>index</em>
+        in the collection or <code class="idl">null</code> if <em>index</em> is out of range.</p> 
+
     <p>The <dfn id="dom-namedflow"><code class="idl">NamedFlow</code></dfn>
     interface offers a representation of the <span>named flow</span>.</p>
     <pre class="idl">
 interface <a href="#dom-namedflow">NamedFlow</a> {
+  readonly attribute <a href="http://www.w3.org/TR/DOM-Level-3-Core/core.html#DOMString">DOMString</a> name;
   readonly attribute boolean <a href="#dom-namedflow-overflow">overflow</a>;
   readonly attribute <a href="http://www.w3.org/TR/DOM-Level-3-Core/core.html#ID-536297177">NodeList</a> contentNodes;
   <a href="http://www.w3.org/TR/DOM-Level-3-Core/core.html#ID-536297177">NodeList</a> getRegionsByContentNode(<a href="http://www.w3.org/TR/DOM-Level-3-Core/core.html#ID-1950641247">Node</a> node);
   };
 };</pre>
 
+    <p>The <dfn id="dom-namedflow-name"><code class="idl">name</code></dfn> attribute
+        value is the name of the <code class="idl">NamedFlow</code> instance.</p>
+
     <p>The <dfn id="dom-namedflow-overflow"><code class=
-    "idl">overflow</code></dfn> property is true if the named flow does not
+    "idl">overflow</code></dfn> attribute value is true if the named flow does not
     fully fit in the associated regions. Otherwise, it is false. A 
     <code class="idl">NamedFlow</code> object is live.</p>
 
-    <p>The <dfn id="dom-namedflow-contentnodes">contentNodes</dfn> property returns an ordered collection 
-        of nodes that constitute the named flow. Note that this collection is live: every time it is 
+    <p>The <dfn id="dom-namedflow-contentnodes">contentNodes</dfn> attribute value is 
+        an ordered collection of nodes that constitute the named flow. Note that this 
+        collection is live: every time it is 
         queried it must return the same object, and the object is always up to date.
     </p>
 
@@ -1635,6 +1696,9 @@ <h3 id="changes_from_June_09_2011">Changes from <a href="http://www.w3.org/TR/20
             the corresponding region and added an issue that the model for 'partial' styling needs to 
             be defined. See <a href="http://lists.w3.org/Archives/Public/www-style/2011Dec/0480.html">mailing list feedback</a>.</li>
         <li>Clarified that the <code>NodeList</code> returned by <code>getRegionsByContentNode</code> is live.</li>
+        <li>Added a name property to the <code>NamedFlow</code> interface. Added a <code>NamedFlowCollection</code>
+            interface and added a <code>getNamedFlows</code> 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>.</li>
     </ul>