Implemented editorial changes from Alex's review http://lists.w3.org/Archives/Public/www-style/2012Feb/0001.html

Author: vhardy

css3-regions/Overview.html

@@ -778,7 +778,8 @@ <h3 id=regions-flow-breaking-rules><span class=secno>2.3. </span>Regions
    element's content across column boxes (see <a href="#CSS3COL"
    rel=biblioentry>[CSS3COL]<!--{{CSS3COL}}--></a>). One difference is that
    page boxes are generated based on the available content whereas regions
-   are a predefined set of recipient boxes for the named flow content.
+   are a set of recipient boxes for the named flow content whose dynamic
+   generation is not in the scope of this specification.
 
   <p><span title=region>Regions</span> are organized in to a <span
    title=region-chain>region chain</span>.
@@ -956,10 +957,18 @@ <h3 id=the-flow-into-property><span class=secno>4.1. </span>The &lsquo;<a
    <p>will move all tables in the &lsquo;<code
     class=property>table-content</code>&rsquo; named flow. However, the</p>
 
+   <pre>table &gt; * {flow-into: table-content} ...</pre>
+
+   <p>selector will move all immediate children of all table elements into
+    the ‘table-content’ named flow (which may be useful as it will
+    usually result, if the immediate children are rows, in merging rows of
+    multiple tables), but the</p>
+
    <pre>table * {flow-into: table-content}</pre>
 
-   <p>selector will move all the descendants of table elements in the
-    &lsquo;<code class=property>table-content</code>&rsquo; named flow. This
+   <p>selector will move all descendants of table elements into the
+    ‘table-content’ named flow, transforming the element tree into a flat
+    list in order of opening tags (which is probably not intentional). This
     will make all the descendants of table elements siblings in the named
     flow. Having the descendants become siblings in the named flow results in
     a different processing (see the <a
@@ -1149,39 +1158,6 @@ <h3 id=the-flow-from-property><span class=secno>4.2. </span>The &lsquo;<a
    potentially impact the content laid out in regions, just as for
    non-regions.
 
-  <div class=example>
-   <p>In the following example, the inline content coming from the <code
-    class=html>body_text</code> <a href="#named-flow0">named flow</a> wraps
-    around the <code class=html>#float</code> box.</p>
-
-   <pre>
-    &lt;style&gt;
-    #float {
-        float: left;
-        width: 100px;
-        height: 300px;
-    }
-
-    #region1, #region2 {
-        width: 200px;
-        height: 200px;
-        flow-from: body_text;
-    }
-
-    #content {
-        flow-into: body_text;
-    }
-    &lt;/style&gt;
-
-    &lt;div id="float"&gt;&lt;/div&gt;
-
-    &lt;div id="region1"&gt;&lt;/div&gt;
-    &lt;div id="region2"&gt;&lt;/div&gt;
-
-    &lt;div id="content"&gt;&lt;/div&gt; 
-    </pre>
-  </div>
-
   <h4 id=auto-width-on-regions><span class=secno>4.2.1. </span>Auto width on
    regions</h4>
 
@@ -1218,8 +1194,7 @@ <h3 id=region-flow-break><span class=secno>4.3. </span>Region flow break
 
   <p>Each break ends layout in the current region and causes remaining pieces
    of content from the named flow to be visually formatted in the following
-   region in the region chain. Note that there is no region break in the last
-   region associated with a named flow.
+   region in the region chain, if there is one.
 
   <p>The following extends the &lsquo;<a href="#break-before"><code
    class=property>break-before</code></a>&rsquo;, &lsquo;<a
@@ -1385,6 +1360,13 @@ <h3 id=region-flow-break><span class=secno>4.3. </span>Region flow break
   <h3 id=the-region-overflow-property><span class=secno>4.4. </span>The
    region-overflow property</h3>
 
+  <div class=issue-marker data-bug_id=15878 data-bug_status=NEW> <a
+   href="https://www.w3.org/Bugs/Public/show_bug.cgi?id=15878">Bug-15878</a>
+   <div class=issue-details>
+    <p class=short-desc>region-overflow:nobreak</p>
+   </div>
+  </div>
+
   <table class=propdef summary="break-after property definition">
    <tbody>
     <tr>
@@ -1928,8 +1910,8 @@ <h3 id=the-namedflow-interface><span class=secno>6.1. </span>The NamedFlow
     </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.
+   class=idl>length</code></dfn> attribute returns 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
@@ -1940,6 +1922,14 @@ <h3 id=the-namedflow-interface><span class=secno>6.1. </span>The NamedFlow
    interface offers a representation of the <a href="#named-flow0">named
    flow</a>.
 
+  <div class=issue-marker data-bug_id=15879 data-bug_status=NEW> <a
+   href="https://www.w3.org/Bugs/Public/show_bug.cgi?id=15879">Bug-15879</a>
+   <div class=issue-details>
+    <p class=short-desc>getRegionsByContentNode and contentNodes: change
+     naming?</p>
+   </div>
+  </div>
+
   <pre class=idl>
 interface <a href="#dom-namedflow">NamedFlow</a> {
   readonly attribute <a
@@ -1951,20 +1941,19 @@ <h3 id=the-namedflow-interface><span class=secno>6.1. </span>The NamedFlow
   <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 <a href="#dom-namedflow"><code
+   attribute returns 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>
-   attribute value is true if the named flow does not fully fit in the
-   associated regions. Otherwise, it is false. A <a
+   attribute returns true if the named flow does not fully fit in the
+   associated regions. Otherwise, it returns false. A <a
    href="#dom-namedflow"><code class=idl>NamedFlow</code></a> object is live.
 
   <p>The <dfn id=dom-namedflow-contentnodes>contentNodes</dfn> attribute
-   value is an ordered collection of nodes that constitute the named flow.
+   returns 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.
 
@@ -2006,22 +1995,19 @@ <h3 id=extension-to-the-element-interface><span class=secno>6.2.
 </pre>
 
   <p>The <dfn id=dom-element-regionoverflow><code
-   class=idl>regionOverflow</code></dfn> attribute can take one of the
+   class=idl>regionOverflow</code></dfn> attribute returns one of the
    following values:
 
   <dl>
    <dt>&lsquo;<a href="#dom-namedflow-overflow"><code
     class=property>overflow</code></a>&rsquo;
 
-   <dd>the region element's content overflows the region's <a
-    href="http://www.w3.org/TR/CSS21/box.html#box-dimensions">content
-    box</a>. Note that the region's <a
+   <dd>the region is the last one in the <span title=region-chain>region
+    chain</span> and not able to fit the remaining content from the <a
+    href="#named-flow0">named flow</a>. Note that the region's <a
     href="http://www.w3.org/TR/CSS21/visufx.html#overflow"><code
     class=idl>overflow</code></a> property value can be used to control the
-    visibility of the overflowing content. This means that the region is the
-    last one in the <span title=region-chain>region chain</span> and not able
-    to fit the remaining content from the <a href="#named-flow0">named
-    flow</a>.
+    visibility of the overflowing content.
 
    <dt>&lsquo;<code class=property>fit</code>&rsquo;
 
@@ -2047,6 +2033,17 @@ <h3 id=extension-to-the-element-interface><span class=secno>6.2.
    <dd>The element is not a <span>region</span>.
   </dl>
 
+  <p>Note that if there is no content in the named flow, all regions
+   associated with that named flow should have their &lsquo;<a
+   href="#dom-namedflow-overflow"><code
+   class=property>overflow</code></a>&rsquo; attribute return &lsquo;<code
+   class=property>empty</code>&rsquo;. If there is content in the flow but
+   that content does not generate any box for visual formatting, the
+   &lsquo;<a href="#dom-namedflow-overflow"><code
+   class=property>overflow</code></a>&rsquo; attribute on the first region in
+   the region chain associated with the flow will return &lsquo;<code
+   class=property>fit</code>&rsquo;.
+
   <p>The <dfn id=dom-element-getregionflowranges>getRegionFlowRanges</dfn>
    method returns an array of <a
    href="http://www.w3.org/TR/DOM-Level-2-Traversal-Range/ranges.html#Level-2-Range-idl">
@@ -2227,6 +2224,10 @@ <h3 id="changes_from_June_09_2011"><span class=secno>10.1. </span>Changes
 
    <li>Modified initial examples as per <a
     href="https://www.w3.org/Bugs/Public/show_bug.cgi?id=15131">Bug 15131</a>
+
+   <li>Multiple editorial changes following <a
+    href="http://lists.w3.org/Archives/Public/www-style/2012Feb/0001.html">mailing
+    list review comments</a>
   </ul>
 
   <h3 id="changes_from_June_09_2011"><span class=secno>10.2. </span>Changes