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

csswg/css3-background Overview.html,1.254,1.255 Overview.src.html,1.266,1.267

From: Elika Etemad via cvs-syncmail <cvsmail@w3.org>
Date: Tue, 20 Dec 2011 05:08:12 +0000
To: public-css-commits@w3.org
Message-Id: <E1Rcrvw-0006M5-Po@lionel-hutz.w3.org>
Update of /sources/public/csswg/css3-background
In directory hutz:/tmp/cvs-serv24415

Modified Files:
	Overview.html Overview.src.html 
Log Message:
Use consistent wording for TRBL properties, remove stray pre-CR issue.

Index: Overview.html
===================================================================
RCS file: /sources/public/csswg/css3-background/Overview.html,v
retrieving revision 1.254
retrieving revision 1.255
diff -u -d -r1.254 -r1.255
--- Overview.html	20 Dec 2011 04:41:48 -0000	1.254
+++ Overview.html	20 Dec 2011 05:08:10 -0000	1.255
@@ -3059,18 +3059,17 @@
      <td>as specified
   </table>
 
-  <p>The four &lsquo;<a href="#border-image-slice"><code
-   class=property>border-image-slice</code></a>&rsquo; values represent
-   inward offsets from the top, right, bottom, and left edges of the image
-   respectively, dividing it into nine regions: four corners, four edges and
-   a middle. The middle image part is discarded (treated as fully
+  <p>This property specifies inward offsets from the top, right, bottom, and
+   left edges of the image, dividing it into nine regions: four corners, four
+   edges and a middle. The middle image part is discarded (treated as fully
    transparent) unless the &lsquo;<code class=css>fill</code>&rsquo; keyword
-   is present. (It is drawn over the background; see the <a
-   href="#border-image-process">border-image drawing process</a>.)
+   is present. (It is drawn over the background; see <a
+   href="#border-image-process">Drawing the Border Image</a>.)
 
-  <p>If the fourth number/percentage is absent, it is the same as the second.
-   If the third one is also absent, it is the same as the first. If the
-   second one is also absent, it is the same as the first.
+  <p>When four values are specified, they set the offsets on the top, right,
+   bottom and left sides in that order. If the left is missing, it is the
+   same as the right; if the bottom is missing, it is the same as the top; if
+   the right is missing, it is the same as the top.
 
   <dl>
    <dt><var>&lt;percentage&gt;</var>
@@ -3173,10 +3172,9 @@
    class=property>border-image-width</code></a>&rsquo; specify offsets that
    are used to divide the border image area into nine parts. They represent
    inward distances from the the top, right, bottom, and left sides of the
-   area, respectively. If the fourth value is absent, it is the same as the
-   second. If the third one is also absent, it is the same as the first. If
-   the second one is also absent, it is the same as the first. Values have
-   the following meanings:
+   area, respectively. If the left width is missing, it is the same as the
+   right; if the bottom is missing, it is the same as the top; if the right
+   is missing, it is the same as the top. Values have the following meanings:
 
   <dl>
    <dt><var>&lt;percentage&gt;</var>
@@ -3202,9 +3200,6 @@
     href="#the-border-width">border-width</a> is used instead.
   </dl>
 
-  <p class=issue>Are percentages of the border-image area useful? Should
-   percentages be used instead of numbers for ratios?
-
   <p>Negative values are not allowed for any &lsquo;<a
    href="#border-image-width"><code
    class=property>border-image-width</code></a>&rsquo; values.
@@ -3275,15 +3270,17 @@
   </table>
 
   <p>The values specify the amount by which the <dfn
-   id=border-image-area>border image area</dfn> extends beyond the border box
-   on the top, right, bottom, and left sides respectively. If the fourth
-   value is absent, it is the same as the second. If the third one is also
-   absent, it is the same as the first. If the second one is also absent, it
-   is the same as the first. Numbers represent multiples of the corresponding
-   <a href="#the-border-width">border-width</a>.
+   id=border-image-area>border image area</dfn> extends beyond the border
+   box. If it has four values, they set the outsets on the top, right, bottom
+   and left sides in that order. If the left is missing, it is the same as
+   the right; if the bottom is missing, it is the same as the top; if the
+   right is missing, it is the same as the top.
 
-  <p>Negative values are not allowed for any of the &lsquo;<a
-   href="#border-image-outset"><code
+  <p>As with &lsquo;<a href="#border-image-width"><code
+   class=property>border-image-width</code></a>&rsquo;, a &lt;number&gt;
+   represents a multiple of the corresponding <a
+   href="#the-border-width">border-width</a>. Negative values are not allowed
+   for any of the &lsquo;<a href="#border-image-outset"><code
    class=property>border-image-outset</code></a>&rsquo; values.
 
   <p>Portions of the border-image that are rendered outside the border box do
@@ -3291,7 +3288,8 @@
    and do not capture such events on behalf of the element.
 
   <p class=note>Note that, even though they never cause a scrolling
-   mechanism, they may still be clipped by an ancestor or by the viewport.
+   mechanism, outset images may still be clipped by an ancestor or by the
+   viewport.
 
   <h3 id=the-border-image-repeat><span class=secno>6.5. </span>The &lsquo;<a
    href="#border-image-repeat"><code
@@ -3343,9 +3341,11 @@
   </table>
 
   <p>This property specifies how the images for the sides and the middle part
-   of the border image are scaled and tiled. If the second keyword is absent,
-   it is assumed to be the same as the first. Values have the following
-   meanings:
+   of the border image are scaled and tiled. The first keyword applies to the
+   horizontal sides, the second to the vertical ones; see <a
+   href="#border-image-process">Drawing the Border Image</a>. If the second
+   keyword is absent, it is assumed to be the same as the first. Values have
+   the following meanings:
 
   <dl>
    <dt><dfn id=stretch>&lsquo;<code class=css>stretch</code>&rsquo;</dfn>

Index: Overview.src.html
===================================================================
RCS file: /sources/public/csswg/css3-background/Overview.src.html,v
retrieving revision 1.266
retrieving revision 1.267
diff -u -d -r1.266 -r1.267
--- Overview.src.html	20 Dec 2011 04:41:48 -0000	1.266
+++ Overview.src.html	20 Dec 2011 05:08:10 -0000	1.267
@@ -2226,16 +2226,17 @@
     <td>as specified
 </table>
 
-<p>The four 'border-image-slice' values represent inward offsets from
-the top, right, bottom, and left edges of the image respectively,
-dividing it into nine regions: four corners, four edges and a middle.
+<p>This property specifies inward offsets from the top, right, bottom,
+and left edges of the image, dividing it into nine regions: four corners,
+four edges and a middle.
 The middle image part is discarded (treated as fully transparent)
 unless the ''fill'' keyword is present. (It is drawn over the background;
-see the <a href="#border-image-process">border-image drawing process</a>.)
+see <a href="#border-image-process">Drawing the Border Image</a>.)
 
-<p>If the fourth number/percentage is absent, it is the same as the
-second. If the third one is also absent, it is the same as the first.
-If the second one is also absent, it is the same as the first.
+<p>When four values are specified, they set the offsets on the top,
+right, bottom and left sides in that order. If the left is missing, it is
+the same as the right; if the bottom is missing, it is the same as the top;
+if the right is missing, it is the same as the top.
 
 <dl>
   <dt><var>&lt;percentage&gt;</var>
@@ -2308,10 +2309,9 @@
 <p>The four values of 'border-image-width' specify offsets that are used
 to divide the border image area into nine parts. They represent inward
 distances from the the top, right, bottom, and left sides of the
-area, respectively. If the fourth value is absent, it is
-the same as the second. If the third one is also absent, it is the same
-as the first. If the second one is also absent, it is the same as the
-first. Values have the following meanings:</p>
+area, respectively. If the left width is missing, it is the same as the right;
+if the bottom is missing, it is the same as the top; if the right is missing,
+it is the same as the top. Values have the following meanings:</p>
 
 <dl>
   <dt><var>&lt;percentage&gt;</var>
@@ -2331,8 +2331,6 @@
     href="#the-border-width">border-width</a> is used
     instead.
 </dl>
-<p class="issue">Are percentages of the border-image area useful? Should
-percentages be used instead of numbers for ratios?</p>
 
 <p>Negative values are not allowed for any 'border-image-width' values.
 
@@ -2380,22 +2378,22 @@
 
 
 <p>The values specify the amount by which the <dfn>border image
-area</dfn> extends beyond the
-border box on the top, right, bottom, and left sides respectively.
-If the fourth value is absent, it is the same as the second. If the
-third one is also absent, it is the same as the first. If the second
-one is also absent, it is the same as the first. Numbers represent
-multiples of the corresponding
-<a href="#the-border-width">border-width</a>.
+area</dfn> extends beyond the border box.
+If it has four values, they set the outsets on the top, right, bottom and
+left sides in that order. If the left is missing, it is the same as the right;
+if the bottom is missing, it is the same as the top; if the right is missing,
+it is the same as the top.
 
-<p>Negative values are not allowed for any of the 'border-image-outset' values.
+<p>As with 'border-image-width', a &lt;number&gt; represents a multiple of the
+corresponding <a href="#the-border-width">border-width</a>.
+Negative values are not allowed for any of the 'border-image-outset' values.
 
 <p>Portions of the border-image that are rendered outside the border
 box do not trigger scrolling. Also such portions are invisible to mouse
 events and do not capture such events on behalf of the element.</p>
 
 <p class=note>Note that, even though they never cause a scrolling
-mechanism, they may still be clipped by an ancestor or by the
+mechanism, outset images may still be clipped by an ancestor or by the
 viewport.
 
 <h3 id="the-border-image-repeat">The 'border-image-repeat' property</h3>
@@ -2429,9 +2427,11 @@
 </table>
 
 <p>This property specifies how the images for the sides and the middle
-part of the border image are scaled and tiled. If the second keyword is
-absent, it is assumed to be the same as the first. Values have the
-following meanings:
+part of the border image are scaled and tiled. The first keyword applies
+to the horizontal sides, the second to the vertical ones; see
+<a href="#border-image-process">Drawing the Border Image</a>.
+If the second keyword is absent, it is assumed to be the same as the first.
+Values have the following meanings:
 
 <dl>
   <dt><dfn>''stretch''</dfn></dt>
Received on Tuesday, 20 December 2011 05:08:14 UTC

This archive was generated by hypermail 2.4.0 : Friday, 17 January 2020 19:26:08 UTC