(merge)

Author: bert-github

css3-animations/Overview.html

@@ -15,15 +15,14 @@
 
    <h1>CSS Animations</h1>
 
-   <h2 class="no-num no-toc" id=longstatus-date>Editor's Draft 17 February
-    2012</h2>
+   <h2 class="no-num no-toc" id=longstatus-date>Editor's Draft 27 March 2012</h2>
 
    <dl>
     <dt>This version:
 
     <dd><a
-     href="http://www.w3.org/TR/2012/ED-css3-animations-20120217/">http://dev.w3.org/csswg/css3-animations/</a>
-     <!--http://www.w3.org/TR/2012/WD-css3-animations-20120217-->
+     href="http://www.w3.org/TR/2012/ED-css3-animations-20120327/">http://dev.w3.org/csswg/css3-animations/</a>
+     <!--http://www.w3.org/TR/2012/WD-css3-animations-20120327-->
 
     <dt>Latest version:
 
@@ -65,20 +64,26 @@ <h2 class="no-num no-toc" id=longstatus-date>Editor's Draft 17 February
      href="https://www.w3.org/Bugs/Public/buglist.cgi?query_format=advanced&amp;product=CSS&amp;component=Animations&amp;resolution=---&amp;cmdtype=doit">in
      Bugzilla</a>
 
+    <dt>Discussion:
+
+    <dd><a
+     href="http://lists.w3.org/Archives/Public/www-style/">www-style@w3.org</a>
+     with subject line &ldquo;<kbd>[css3-animations] <var>&hellip; message
+     topic &hellip;</var></kbd>&rdquo;
+
     <dt>Test suite:
 
     <dd>none yet
    </dl>
    <!--begin-copyright-->
    <p class=copyright><a
     href="http://www.w3.org/Consortium/Legal/ipr-notice#Copyright"
-    rel=license>Copyright</a> &copy; 2012 <a
-    href="http://www.w3.org/"><acronym
-    title="World Wide Web Consortium">W3C</acronym></a><sup>&reg;</sup> (<a
-    href="http://www.csail.mit.edu/"><acronym
-    title="Massachusetts Institute of Technology">MIT</acronym></a>, <a
-    href="http://www.ercim.eu/"><acronym
-    title="European Research Consortium for Informatics and Mathematics">ERCIM</acronym></a>,
+    rel=license>Copyright</a> &copy; 2012 <a href="http://www.w3.org/"><abbr
+    title="World Wide Web Consortium">W3C</abbr></a><sup>&reg;</sup> (<a
+    href="http://www.csail.mit.edu/"><abbr
+    title="Massachusetts Institute of Technology">MIT</abbr></a>, <a
+    href="http://www.ercim.eu/"><abbr
+    title="European Research Consortium for Informatics and Mathematics">ERCIM</abbr></a>,
     <a href="http://www.keio.ac.jp/">Keio</a>), All Rights Reserved. W3C <a
     href="http://www.w3.org/Consortium/Legal/ipr-notice#Legal_Disclaimer">liability</a>,
     <a

css3-animations/Overview.src.html

@@ -44,6 +44,9 @@ <h2 class="no-num no-toc">[LONGSTATUS] [DATE]</h2>
   <dt>Issues list:
     <dd><a href="https://www.w3.org/Bugs/Public/buglist.cgi?query_format=advanced&amp;product=CSS&amp;component=Animations&amp;resolution=---&amp;cmdtype=doit">in Bugzilla</a>
 
+  <dt>Discussion:</dt>
+    <dd><a href="http://lists.w3.org/Archives/Public/www-style/">www-style@w3.org</a> with subject line &ldquo;<kbd>[[SHORTNAME]] <var>&hellip; message topic &hellip;</var></kbd>&rdquo;
+
   <dt>Test suite:
     <dd>none yet
 </dl>

css3-background/Overview.html

@@ -2759,7 +2759,7 @@ <h3 id=the-border-radius><span class=secno>5.1. </span>Curve Radii: the
    copied from the first. If either length is zero, the corner is square, not
    rounded. Percentages for the horizontal radius refer to the width of the
    border box, whereas percentages for the vertical radius refer to the
-   height of the border box.
+   height of the border box. Negative values are not allowed.
 
   <div class=figure>
    <p><img alt="Diagram of the inscribed ellipse" src=corner.png>
@@ -2816,9 +2816,9 @@ <h3 id=corner-shaping><span class=secno>5.2. </span>Corner Shaping</h3>
    adjoining borders are of different thicknesses the corner will show a
    smooth transition between the thicker and thinner borders.
 
-  <p class=note>Note that this means that if the outer curve extends past the
-   adjacent corner's padding edge, the inner curve may not be a full quarter
-   ellipse.
+  <p class=note>Note that this means that if the center of the outer curve is
+   past the opposite side's padding edge, the inner curve might not be a full
+   quarter ellipse.
 
   <p>All border styles (&lsquo;<code class=css>solid</code>&rsquo;,
    &lsquo;<code class=css>dotted</code>&rsquo;, &lsquo;<code

css3-background/Overview.src.html

@@ -1917,7 +1917,7 @@ <h3 id="the-border-radius">Curve Radii: the 'border-radius' properties</h3>
 If either length is zero, the corner is square, not rounded.
 Percentages for the horizontal radius refer to the width of the
 border box, whereas percentages for the vertical radius refer to
-the height of the border box.
+the height of the border box. Negative values are not allowed.
 
 <div class="figure">
   <p><img alt="Diagram of the inscribed ellipse" src="corner.png">
@@ -1973,9 +1973,9 @@ <h3 id="corner-shaping">Corner Shaping</h3>
 when two adjoining borders are of different thicknesses the corner will
 show a smooth transition between the thicker and thinner borders.
 
-<p class="note">Note that this means that if the outer curve extends
-past the adjacent corner's padding edge, the inner curve may not be
-a full quarter ellipse.</p>
+<p class="note">Note that this means that if the center of the outer curve
+is past the opposite side's padding edge, the inner curve might not be a
+full quarter ellipse.</p>
 
 <p>All border styles (''solid'', ''dotted'',  ''inset'', etc.)
 follow the curve of the border.

css3-regions/Overview.src.html

@@ -1237,7 +1237,7 @@ <h3 id="the-region-overflow-property">The region-overflow property</h3>
         "https://www.w3.org/Bugs/Public/show_bug.cgi?id=15832">Bug-15832</a>
 
         <div class="issue-details">
-            <p class="short-desc">Should we have region-overflow:nobreak and have region-overflow apply to all regions, not just the last?</p>
+            <p class="short-desc">Should we have region-overflow:nobreak and have 'region-overflow' apply to all regions, not just the last?</p>
         </div>
     </div>
 
@@ -1686,6 +1686,19 @@ <h2 id="cssom_view_and_css_regions">CSSOM view and CSS regions</h2>
     </div>
 
     <h3 id="the-namedflow-interface">The NamedFlow interface</h3>
+    
+    <p>A <span>named flow</span> is created when it becomes referenced by the 
+        'flow-into' and 'flow-from' computed values. The following APIs also allow
+        scripts to reference a <code class="idl">NamedFlow</code> object representation
+        of a <span>named flow</span>.</p>
+        
+    <p>The possible states for a <span>named flow</span> are described in the following 
+        figure and referenced in subsequent text.</p>
+        
+    <div class="figure">
+        <img src="images/named-flow-states.svg" alt="NamedFlow states" width="600px" />
+        <p class="caption"><span>named flow</span> states and transitions</p>
+    </div>
 
     <div class="issue-marker" data-bug_id="14948" data-bug_status="NEW">
         <a href=
@@ -1704,22 +1717,44 @@ <h3 id="the-namedflow-interface">The NamedFlow interface</h3>
     <pre class="idl">
 partial interface <a href=
 "http://www.w3.org/TR/dom/#interface-document">Document</a> {
-  <a href="#dom-namedflow">NamedFlow</a> getFlowByName(DOMString name);
-  <a href="#dom-namedflow-collection">NamedFlowCollection</a> getNamedFlows();
+  <a href="#dom-namedflow">NamedFlow?</a> getFlowByName(DOMString name);
+  readonly attribute <a href="#dom-namedflow-collection">NamedFlowCollection</a> namedFlows;
 };               
 </pre>
 
-    <p>The <code class="idl">getNamedFlows</code> method on the <a href=
+    <p>The <code class="idl">namedFlows</code> attribute on the <a href=
     "http://www.w3.org/TR/dom/#interface-document"><code class=
-    "idl">Document</code></a> interface returns the list of all the <span>named
+    "idl">Document</code></a> interface returns the live list of all the current <span>named
     flow</span>s in the document.</p>
 
+    <p>The <code class="idl">namedFlows</code> collection must include all <span>named flow</span> 
+    that are currently in the <code>CREATED</code> and <code>CREATED-REFERENCED</code>state. 
+    The list may include <span>named flows</span>
+    that are in the <code>REFERENCED</code> state. The list
+    may also include <span>named flow</code> instances that are in the STALE state.</p>
+    
     <p>The <code class="idl">getFlowByName</code> method on the <a href=
     "http://www.w3.org/TR/dom/#interface-document"><code class=
     "idl">Document</code></a> interface provides access to the document's <span
-    >named flow</span> instances.</p>
+    >named flow</span> instances. The return value depends on the <span>named flow</span>
+    state:</p>
+    
+    <ul>
+        <li><code class="idl">NULL</code>: the user agent must return <code>null</code></li> 
+        <li><code class="idl">STALE</code> the user agent may return null or a valid 
+            <code class="idl">NamedFlow</code> instance. 
+            If the user agent returns a valid instance, subsequent calls to the <code class="idl">getFlowByName</code> method
+            must return the same object instance, no matter what the state of the 
+            <span>named flow</span> is.</li>
+        <li><code class="idl">CREATED</code> or <code class="idl">CREATED-REFERENCED</code>: the 
+            user agent must return a valid <code class="idl">NamedFlow</code> instance.</li>
+        <li><code class="idl">REFERENCED</code>: the user agent may return <code>null</code> or it may return a 
+            valid <code class="idl">NamedFlow</code> instance. If the user agent returns a 
+            valid object, subsequent calls to the <code class="idl">getFlowByName</code> method
+            must return the same object instance, no matter what the state of the 
+            <span>named flow</span> is.</li>
+    </ul>
 
-
     <div class="issue-marker" data-bug_id="15828" data-bug_status="NEW">
         <a href=
         "https://www.w3.org/Bugs/Public/show_bug.cgi?id=15828">Bug-15828</a>
@@ -1806,33 +1841,35 @@ <h3 id="extension-to-the-element-interface">Extension to the Element
     <pre class="idl">
 partial interface <a href=
 "http://www.w3.org/TR/dom/#interface-element">Element</a> {
-    readonly attribute DOMString <a href="#dom-element-regionoverflow">regionOverflow</a>;
+    readonly attribute DOMString <a href="#dom-element-regionoverset">regionOverset</a>;
     sequence&lt;<a href="#">Range</a>&gt; <a href=
 "#dom-element-getregionflowranges">getRegionFlowRanges()</a>;
 };               
 
 </pre>
 
-    <p>The <dfn id="dom-element-regionoverflow"><code class=
-    "idl">regionOverflow</code></dfn> attribute returns one of the following
+    <p>The <dfn id="dom-element-regionoverset"><code class=
+    "idl">regionOverset</code></dfn> attribute returns one of the following
     values:</p>
 
     <dl>
-        <dt>'overflow'</dt>
+        <dt>'overset'</dt>
 
         <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 <span>named flow</span>.
         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. </dd>
+        visibility of the overflowing content and the 
+        'region-overflow' property controls whether or not fragmentation happens 
+        on the content that flows in the last region.</dd>
 
         <dt>'fit'</dt>
 
-        <dd>the region element's content fits into the region's <a href=
+        <dd>the region element's flow fragment content fits into the region's <a href=
         "http://www.w3.org/TR/CSS21/box.html#box-dimensions">content box</a>.
-        It does not overflow. If the region is the last one in the <span title=
+        If the region is the last one in the <span title=
         "region-chain">region chain</span>, it means that the content fits
         without overflowing. If the region is not the last one in the region
         chain, that means the <span>named flow</span>
@@ -1846,9 +1883,6 @@ <h3 id="extension-to-the-element-interface">Extension to the Element
         <dd>the region element has no content and is empty. All content from
         the <span>named flow</span> was fitted in regions
         with a lower document order.</dd>
-        
-        <dt>'undefined'</dt>
-        <dd>The element is not a <span>region</span>.</dd>
     </dl>
 
     <p>Note that if there is no content in the named flow, all regions associated
@@ -1969,6 +2003,9 @@ <h3 id="changes_from_June_09_2011">Changes from <a href="http://www.w3.org/TR/20
         <li>Fixed DOM references to now point to the DOM TR</li>
         <li>Fixed Web IDL issues as reported in <a href="https://www.w3.org/Bugs/Public/show_bug.cgi?id=15931">Issue 15931</a></li>
         <li>Added text to explain support for multi-column elements as required by <a href="https://www.w3.org/Bugs/Public/show_bug.cgi?id=15191">Issue 15191</a> and <a href="http://www.w3.org/Style/CSS/Tracker/actions/375">Action 375</a>.</li>
+        <li>Renamed 'regionOverflow' to 'regionOverset' to avoid confusion between fitting a flow in 
+            regions and the concept of visual overflow that the word 'overflow' (and the property) carry.</li>
+        <li>Reworked the partial document interface following the <a href="https://www.w3.org/Bugs/Public/show_bug.cgi?id=14948">Issue 14948</a> on <code>getFlowByName</code>.</li>
     </ul>