W3C home > Mailing lists > Public > public-css-commits@w3.org > October 2011

csswg/css3-exclusions Exclusions.src.html,1.10,1.11 Overview.html,1.10,1.11

From: Rossen Atanassov via cvs-syncmail <cvsmail@w3.org>
Date: Fri, 28 Oct 2011 06:01:54 +0000
To: public-css-commits@w3.org
Message-Id: <E1RJfVq-0006Pw-99@lionel-hutz.w3.org>
Update of /sources/public/csswg/css3-exclusions
In directory hutz:/tmp/cvs-serv24635

Modified Files:
	Exclusions.src.html Overview.html 
Log Message:
Changed the max-width of the wrap-through example from 50% to 40% to match all other examples.
Removed the restriction of circle radius not allowed to be in %. This was a copy from the original spec and I don't see any reason to have such a rule.
Changed occurrences from <image> to <uri>
Minor spelling changes
Resolved Issue 1 and Issue 2.

Index: Overview.html
===================================================================
RCS file: /sources/public/csswg/css3-exclusions/Overview.html,v
retrieving revision 1.10
retrieving revision 1.11
diff -u -d -r1.10 -r1.11
--- Overview.html	27 Oct 2011 01:40:04 -0000	1.10
+++ Overview.html	28 Oct 2011 06:01:52 -0000	1.11
@@ -76,19 +76,19 @@
 
  <body>
   <div class=head id=div-head> <!--begin-logo-->
-   <p><a href="http://www.w3.org/"><img alt=W3C height=48
+   <p id=x><a href="http://www.w3.org/"><img alt=W3C height=48
     src="http://www.w3.org/Icons/w3c_home" width=72></a> <!--end-logo-->
 
    <h1 id=css-exclusions-module>CSS exclusions and shapes</h1>
 
-   <h2 class="no-num no-toc" id=longstatus-date>Editor's Draft 27 October
+   <h2 class="no-num no-toc" id=longstatus-date>Editor's Draft 28 October
[...1390 lines suppressed...]
   <h2 class=no-num id=references>References</h2>
 
@@ -1819,7 +1889,7 @@
       title="'shape-inside', '&lt;shape&gt;'"><strong>4.3.2.</strong></a>
 
      <li>&lsquo;<code class=css>&lt;uri&gt;</code>&rsquo;, <a
-      href="#ltimagegt"
+      href="#lturigt0"
       title="'shape-inside', '&lt;uri&gt;'"><strong>4.3.2.</strong></a>
     </ul>
 
@@ -1929,7 +1999,7 @@
 
      <td>no
 
-     <td>alpha channel of the image specified by &lt;image&gt;
+     <td>alpha channel of the image specified by &lt;uri&gt;
 
      <td>visual
 

Index: Exclusions.src.html
===================================================================
RCS file: /sources/public/csswg/css3-exclusions/Exclusions.src.html,v
retrieving revision 1.10
retrieving revision 1.11
diff -u -d -r1.10 -r1.11
--- Exclusions.src.html	27 Oct 2011 01:40:04 -0000	1.10
+++ Exclusions.src.html	28 Oct 2011 06:01:52 -0000	1.11
@@ -137,29 +137,34 @@
     <dfn>Exclusion element</dfn>
     
     <p>
-        An element that defines an <span>exclusion area</span>s for other elements. The 'wrap-flow' property
-        is used to make an element an exclusion element. An exclusion element contributes its 
-        <span>exclusion area</span> to its <a href="http://www.w3.org/TR/CSS2/visudet.html#containing-block-details">containing block</a>'s 
-        <span>wrapping context</span>
+        An element that defines an <span>exclusion area</span> for other elements. The 'wrap-flow'
+        property is used to make an element an exclusion element. An exclusion element contributes
+        its <span>exclusion area</span> to its <a href="http://www.w3.org/TR/CSS2/visudet.html#containing-block-details">
+        containing block's</a> <span>wrapping context</span>
     </p>
     
     <dfn>Exclusion area</dfn>
     <p>
-        The area used for excluding inline flow content around an exclusion element. By default the
-        area is equivalent to the <a href="http://www.w3.org/TR/CSS2/box.html#box-dimensions">border box</a>. 
-        This specification's 'shape-outside' property can define arbitrary, non-rectangular exclusion areas. 
+        The area used for excluding inline flow content around an exclusion element. The
+        exclusion area is equivalent to the <a href="http://www.w3.org/TR/CSS2/box.html#box-dimensions">
+        border box</a> for elements with 'float' property computed to 'none' and the
+        <a href="http://www.w3.org/TR/CSS2/box.html#box-dimensions">margin box</a> for elements
+        with 'float' property computed to a value other than 'none'. This specification's
+        'shape-outside' property can be used to define arbitrary, non-rectangular exclusion
+        areas.
     </p>
     
     <dfn>Wrapping context</dfn>
     
     <p>
-        An element's wrapping context holds the collection of areas that an element should 'wrap around'
-        when laying out its inline flow content. An element will wrap its content in the area that 
-        correspond to the subtraction of its wrapping context from its own <span>content area</span>.
+        The wrapping context of an element is a collection of 'exclusion areas'. The wrapping
+        context is used to wrap around inline flow content during layout. An element will
+        wrap its inline flow content in the area that corresponds to the subtraction of
+        its wrapping context from its own <span>content area</span>.
     </p>
     
     <p>
-        An element inherit its 
+        An element inherits its 
         <a href="http://www.w3.org/TR/CSS2/visudet.html#containing-block-details">containing block's</a> 
         wrapping context unless it specifically 
         resets it using the 'wrap-through' property.
@@ -175,8 +180,8 @@
     <dfn title="outside-inside">Outside and inside</dfn>
     
     <p>
-        In this specification, ‘outside’ refers to DOM content that is not a descendant of an element 
-        while 'inside’ refers to the element's descendants.
+        In this specification, 'outside' refers to DOM content that is not a descendant of an element 
+        while 'inside' refers to the element's descendants.
     </p>
     
     <h2 id="exclusions">Exclusions</h2>
@@ -552,7 +557,7 @@
 &lt;/div&gt;
 </code></pre>
 
-        <img class="singleImgExample" src="images/exclusion_wrap_through.png" alt="Example rendering of wrap-through: wrap | none" style="max-width:50%"/>
+        <img class="singleImgExample" src="images/exclusion_wrap_through.png" alt="Example rendering of wrap-through: wrap | none" style="max-width:40%"/>
     </div>
     <!-- End section "wrap-through property" -->
 
@@ -602,20 +607,17 @@
     <!-- End section "Propagation of Exclusions" -->
     
     <h3 id="exclusions-order">Exclusions order</h3>
-
-    <div class="issue-marker"><p class="desc"><strong>Issue 1</strong>: z-index only applies to positioned elements. Since any element can 
-        be an exclusion and since they can overlap, should we say that the order of a statically positioned
-        exclusion cannot be controlled?</p></div>
-
     <p>
-        Exclusions follow the painting order (See [[!CSS21]] Appendix E). Exclusions are applied in reverse
-        to the document order in which they are defined. The last exclusion appears on top
-        of all other exclusion, thus it affects the inline flow content of all other preceding
-        exclusions or elements descendant of the same containing block. To change the ordering
-        of positioned exclusions, z-index can be used.
+        Exclusions follow the painting order (See [[!CSS21]] Appendix E). Exclusions are
+        applied in reverse to the document order in which they are defined. The last exclusion
+        appears on top of all other exclusion, thus it affects the inline flow content of
+        all other preceding exclusions or elements descendant of the same containing block.
+        To change the ordering of exclusions with 'position' property computed to a value
+        other than 'static', 'z-index' can be used. Exclusions with 'position' property
+        computed to 'static' are not affected by the 'z-index' property, thus follow the painting
+        order.
     </p>
-        
-
+    
     <div class="example">
         <p>Ordering of exclusions.</p>
 <pre><code class="html">
@@ -753,7 +755,7 @@
               <ul>
                   <li><strong>cx</strong> - The x-axis coordinate of the center of the circle</li>
                   <li><strong>cy</strong> - The y-axis coordinate of the center of the circle</li>
-                  <li><strong>r</strong> - The radius of the circle. Note, cannot be expressed as a percentage.</li>
+                  <li><strong>r</strong> - The radius of the circle</li>
               </ul>
           </dd>
           <dt>ellipse(cx, cy, rx, ry)</dt>
@@ -811,29 +813,25 @@
 &lt;div class="in-a-path"&gt;...&lt;/div&gt;
           </pre></code>
       </div>
-      
-      <p>When using the SVG syntax or referencing SVG elements to define shapes, all the lengths expressed
-      in percentages are resolved from the border box of the element. The coordinate system for the 
-      shape has its origin on the top-left corder of the border box with the x-axis running to the right
-      and the y-axis running downwards. If the SVG element uses unitless coordinate values, they are equivalent
-      to using 'px' units. If the border box of the element is dependent on auto sizing (i.e., the element's
-      'width' or 'height' property is 'auto'), then the percentage values are computed agains '0' and resolve to 0.</p>
-     
-    <!-- End section "Shapes from SVG Syntax -->
+        <p>
+            When using the SVG syntax or referencing SVG elements to define shapes, all the
+            lengths expressed in percentages are resolved from the border box of the element.
+            The coordinate system for the shape has its origin on the top-left corder of the
+            border box with the x-axis running to the right and the y-axis running downwards.
+            If the SVG element uses unitless coordinate values, they are equivalent to using
+            'px' units. If the border box of the element is dependent on auto sizing (i.e.,
+            the element's 'width' or 'height' property is 'auto'), then the percentage values
+            are computed agains '0' and resolve to 0.
+        </p>
+        <!-- End section "Shapes from SVG Syntax -->
       
       <h3 id="shapes-from-image">Shapes from Image</h3>
       <p>
           Another way of defining shapes is by specifying a source image whose alpha channel
-          is used to compute the inside or outside shape. When shapes are computed from an image, all
-          values of the 'background-image' property can be applied.
-      </p>
-      
-      <div class="issue-marker"><p class="desc"><strong>Issue 2</strong>: Need to clarify what we mean by this last sentence.</div>
-      
-      <p>
-          The shape is computed to be the path that encloses the area where the opacity of
-          the specified image is greater than the 'shape-image-threshold' value. If the 'shape-image-threshold'
-          is not specified, the initial value to be considered is 0.5.
+          is used to compute the inside or outside shape. The shape is computed to be the
+          path that encloses the area where the opacity of the specified image is greater
+          than the 'shape-image-threshold' value. If the 'shape-image-threshold' is not specified,
+          the initial value to be considered is 0.5.
       </p>
       
       <p class="note">
@@ -995,7 +993,7 @@
         </dd>
     </dl>
     <dl>
-        <dt><dfn title="'shape-inside'!!'&lt;uri&gt;'">&lt;image&gt;</dfn></dt>
+        <dt><dfn title="'shape-inside'!!'&lt;uri&gt;'">&lt;uri&gt;</dfn></dt>
         <dd>
             If the &lt;uri&gt; references an SVG shape element, that element defines the shape.
               Otherwise, if the &lt;uri&gt; references an image, the shape is extracted and computed 
@@ -1041,7 +1039,7 @@
         </tr>
         <tr>
             <th>Percentages:</th>
-            <td>alpha channel of the image specified by &lt;image&gt;</td>
+            <td>alpha channel of the image specified by &lt;uri&gt;</td>
         </tr>
         <tr>
             <th>Media:</th>
Received on Friday, 28 October 2011 06:01:56 GMT

This archive was generated by hypermail 2.2.0+W3C-0.50 : Friday, 28 October 2011 06:01:57 GMT