Address dbaron's editorial comments <http://lists.w3.org/Archives/Public/www-style/2012Mar/0338.html>

Author: fantasai

css3-images/Overview.html

@@ -16,14 +16,14 @@
 
    <h1>CSS Image Values and Replaced Content Module Level 3</h1>
 
-   <h2 class="no-num no-toc" id=longstatus-date>Editor's Draft 1 March 2012</h2>
+   <h2 class="no-num no-toc" id=longstatus-date>Editor's Draft 13 March 2012</h2>
 
    <dl>
     <dt>This Version:
 
     <dd><a
      href="http://dev.w3.org/csswg/css3-images/">http://dev.w3.org/csswg/css3-images/</a>
-     <!-- <dd><a href="http://www.w3.org/TR/2012/ED-css3-images-20120301/">http://www.w3.org/TR/2012/WD-css3-images-20120301/</a>-->
+     <!-- <dd><a href="http://www.w3.org/TR/2012/ED-css3-images-20120313/">http://www.w3.org/TR/2012/WD-css3-images-20120313/</a>-->
 
 
     <dt>Latest Version:
@@ -625,6 +625,7 @@ <h4 id=image-fallbacks><span class=secno>3.2.2. </span> Image Fallbacks</h4>
 
    <pre>background-image: image('cat_meme.gif#frame=5', 'lolcat.png');</pre>
   </div>
+  <!-- XXX SVG fragment example with spriting / fallbacks -->
 
   <h4 id=solid-color-images><span class=secno>3.2.3. </span> Solid-color
    Images</h4>
@@ -1099,18 +1100,20 @@ <h4 class=no-toc id=linear-gradient-syntax><span class=secno>4.1.1. </span>
   <p>The first argument to the function specifies the <dfn
    id=gradient-line>gradient line</dfn>, which gives the gradient a direction
    and determines how color-stops are positioned. It may be omitted; if so,
-   it defaults to "to bottom".
+   it defaults to &lsquo;<code class=css>to bottom</code>&rsquo;.
 
   <p>The <a href="#gradient-line"><i title="gradient line">gradient
    line's</i></a> direction may be specified in two ways:
 
   <dl>
-   <dt>by angle
+   <dt>using angles
 
-   <dd>For the purpose of this argument, 0deg points upward, and positive
-    angles represent clockwise rotation, so 90deg point toward the right.
+   <dd>For the purpose of this argument, &lsquo;<code
+    class=css>0deg</code>&rsquo; points upward, and positive angles represent
+    clockwise rotation, so &lsquo;<code class=css>90deg</code>&rsquo; point
+    toward the right.
 
-   <dt>by keyword
+   <dt>using keywords
 
    <dd>
     <p>If the argument is &lsquo;<code class=css>to top</code>&rsquo;,
@@ -1133,11 +1136,11 @@ <h4 class=no-toc id=linear-gradient-syntax><span class=secno>4.1.1. </span>
 
   <p>Starting from the center of the <a href="#gradient-box"><i>gradient
    box</i></a>, extend a line at the specified angle in both directions. The
-   ending-point is the point on the <a href="#gradient-line"><i>gradient
+   ending point is the point on the <a href="#gradient-line"><i>gradient
    line</i></a> where a line drawn perpendicular to the <a
    href="#gradient-line"><i>gradient line</i></a> would intersect the corner
    of the <a href="#gradient-box"><i>gradient box</i></a> in the specified
-   direction. The starting-point is determined identically, but in the
+   direction. The starting point is determined identically, but in the
    opposite direction.
 
   <p class=note>It is expected that the next level of this module will
@@ -1146,37 +1149,37 @@ <h4 class=no-toc id=linear-gradient-syntax><span class=secno>4.1.1. </span>
 
   <div class=example>
    <div style="overflow: hidden"> <img
-    alt="[An image showing a box with a background shading gradually from white in the bottom-left corner to black in the top-right corner.  There is a line, illustrating the gradient line, angled at 45 degrees and passing through the center of the box.  The starting-point and ending-point of the gradient line are indicated by the intersection of the gradient line with two additional lines that pass through the bottom-left and top-right corners of the box.]"
+    alt="[An image showing a box with a background shading gradually from white in the bottom-left corner to black in the top-right corner.  There is a line, illustrating the gradient line, angled at 45 degrees and passing through the center of the box.  The starting point and ending point of the gradient line are indicated by the intersection of the gradient line with two additional lines that pass through the bottom-left and top-right corners of the box.]"
     src=gradient-diagram.png style="float: right; margin-left: 1em;">
     <p>This example illustrates visually how to calculate the <a
      href="#gradient-line"><i>gradient line</i></a> from the rules above.
-     This shows the starting and ending-point of the <a
+     This shows the starting and ending point of the <a
      href="#gradient-line"><i>gradient line</i></a>, along with the actual
      gradient, produced by an element with &lsquo;<code class=css>background:
      linear-gradient(45deg, white, black);</code>&rsquo;.</p>
 
-    <p>Notice how, though the starting-point and ending-point are outside of
+    <p>Notice how, though the starting point and ending point are outside of
      the box, they're positioned precisely right so that the gradient is pure
      white <em>exactly</em> at the corner, and pure black <em>exactly</em> at
      the opposite corner. That's intentional, and will always be true for
      linear gradients.</p>
    </div>
   </div>
 
-  <p>The gradient's color stops are typically placed between the
-   starting-point and ending-point on the <a
-   href="#gradient-line"><i>gradient line</i></a>, but this isn't required -
-   the <a href="#gradient-line"><i>gradient line</i></a> extends infinitely
-   in both directions. The starting-point and ending-point are merely
-   arbitrary location markers - the starting-point defines where 0%, 0px, etc
-   are located when specifying color-stops, and the ending-point defines
-   where 100% is located. Color-stops are allowed to have positions before 0%
-   or after 100%.
-
-  <p>The color of the gradient at any point is determined by first finding
-   the unique line passing through that point that is perpendicular to the <a
-   href="#gradient-line"><i>gradient line</i></a>. The point's color is then
-   the color of the <a href="#gradient-line"><i>gradient line</i></a> at the
+  <p>The gradient's color stops are typically placed between the starting
+   point and ending point on the <a href="#gradient-line"><i>gradient
+   line</i></a>, but this isn't required - the <a
+   href="#gradient-line"><i>gradient line</i></a> extends infinitely in both
+   directions. The starting point and ending point are merely arbitrary
+   location markers - the starting point defines where 0%, 0px, etc are
+   located when specifying color-stops, and the ending point defines where
+   100% is located. Color-stops are allowed to have positions before 0% or
+   after 100%.
+
+  <p>The color of the gradient at any point is determined by finding the
+   unique line passing through that point that is perpendicular to the <a
+   href="#gradient-line"><i>gradient line</i></a>. The point's color is the
+   color of the <a href="#gradient-line"><i>gradient line</i></a> at the
    point where this line intersects it.</p>
   <!-- ====================================================================== -->
 
@@ -1647,9 +1650,9 @@ <h3 id=color-stop-syntax><span class=secno>4.4. </span> Gradient
    href="#gradient-line"><i>gradient line</i></a> at the beginning of the
    rule. Color-stops must be specified in order. Percentages refer to the
    length of the gradient line, with 0% being at the starting point and 100%
-   being at the ending point. Lengths are measured from the starting-point in
-   the direction of the ending-point. Color-stops are usually placed between
-   the starting-point and ending-point, but that's not required; the gradient
+   being at the ending point. Lengths are measured from the starting point in
+   the direction of the ending point. Color-stops are usually placed between
+   the starting point and ending point, but that's not required; the gradient
    line extends infinitely in both directions, and a color-stop can be placed
    at any position on the line.
 

css3-images/Overview.src.html

@@ -580,51 +580,51 @@ <h4 class='no-toc' id='linear-gradient-syntax'>
 
 	<p>The first argument to the function specifies the <dfn>gradient line</dfn>, 
 	which gives the gradient a direction and determines how color-stops are 
-	positioned.  It may be omitted; if so, it defaults to "to bottom".</p>
+	positioned.  It may be omitted; if so, it defaults to ''to bottom''.</p>
 
 	<p>The <i title="gradient line">gradient line's</i> direction may be specified in two ways:</p>
 
 	<dl>
-		<dt>by angle</dt>
-		<dd>For the purpose of this argument, 0deg points upward, and positive angles represent clockwise rotation, so 90deg point toward the right.</dd>
+		<dt>using angles</dt>
+		<dd>For the purpose of this argument, ''0deg'' points upward, and positive angles represent clockwise rotation, so ''90deg'' point toward the right.</dd>
 
-		<dt>by keyword</dt>
+		<dt>using keywords</dt>
 		<dd>
 			<p>If the argument is ''to top'', ''to right'', ''to bottom'', or ''to left'', the angle of the <i>gradient line</i> is ''0deg'', ''90deg'', ''180deg'', or ''270deg'', respectively.</p>
 
 			<p>If the argument instead specifies a corner of the box such as ''to top left'', the gradient line must be angled such that it points into the same quadrant as the specified corner, and a line drawn perpendicular to the <i>gradient line</i> through the center of the <i>gradient box</i> intersects the two neighboring corners.</p>
 		</dd>
 	</dl>
 
-	<p>Starting from the center of the <i>gradient box</i>, extend a line at the specified angle in both directions.  The ending-point is the point on the <i>gradient line</i> where a line drawn perpendicular to the <i>gradient line</i> would intersect the corner of the <i>gradient box</i> in the specified direction.  The starting-point is determined identically, but in the opposite direction.</p>
+	<p>Starting from the center of the <i>gradient box</i>, extend a line at the specified angle in both directions.  The ending point is the point on the <i>gradient line</i> where a line drawn perpendicular to the <i>gradient line</i> would intersect the corner of the <i>gradient box</i> in the specified direction.  The starting point is determined identically, but in the opposite direction.</p>
 
 	<p class='note'>It is expected that the next level of this module will provide the ability to define the gradient's direction relative to the current text direction and writing-mode.</p>
 
 	<div class=example>
 		<div style="overflow: hidden">
-			<img style="float: right; margin-left: 1em;" src='gradient-diagram.png' alt="[An image showing a box with a background shading gradually from white in the bottom-left corner to black in the top-right corner.  There is a line, illustrating the gradient line, angled at 45 degrees and passing through the center of the box.  The starting-point and ending-point of the gradient line are indicated by the intersection of the gradient line with two additional lines that pass through the bottom-left and top-right corners of the box.]">
+			<img style="float: right; margin-left: 1em;" src='gradient-diagram.png' alt="[An image showing a box with a background shading gradually from white in the bottom-left corner to black in the top-right corner.  There is a line, illustrating the gradient line, angled at 45 degrees and passing through the center of the box.  The starting point and ending point of the gradient line are indicated by the intersection of the gradient line with two additional lines that pass through the bottom-left and top-right corners of the box.]">
 			<p>This example illustrates visually how to calculate the 
 			<i>gradient line</i> from the rules above.  This shows the starting 
-			and ending-point of the <i>gradient line</i>, along with the actual 
+			and ending point of the <i>gradient line</i>, along with the actual
 			gradient, produced by an element with 
 			''background: linear-gradient(45deg, white, black);''.</p>
-			<p>Notice how, though the starting-point and ending-point are outside 
+			<p>Notice how, though the starting point and ending point are outside
 			of the box, they're positioned precisely right so that the gradient 
 			is pure white <em>exactly</em> at the corner, and pure black 
 			<em>exactly</em> at the opposite corner.  That's intentional, and 
 			will always be true for linear gradients.</p>
 		</div>
 	</div>
 
-	<p>The gradient's color stops are typically placed between the starting-point 
-	and ending-point on the <i>gradient line</i>, but this isn't required - the 
-	<i>gradient line</i> extends infinitely in both directions.  The starting-point 
-	and ending-point are merely arbitrary location markers - the starting-point 
+	<p>The gradient's color stops are typically placed between the starting point
+	and ending point on the <i>gradient line</i>, but this isn't required - the
+	<i>gradient line</i> extends infinitely in both directions.  The starting point
+	and ending point are merely arbitrary location markers - the starting point
 	defines where 0%, 0px, etc are located when specifying color-stops, and 
-	the ending-point defines where 100% is located.  Color-stops are allowed 
+	the ending point defines where 100% is located.  Color-stops are allowed
 	to have positions before 0% or after 100%.</p>
 
-	<p>The color of the gradient at any point is determined by first finding the unique line passing through that point that is perpendicular to the <i>gradient line</i>.  The point's color is then the color of the <i>gradient line</i> at the point where this line intersects it.</p>
+	<p>The color of the gradient at any point is determined by finding the unique line passing through that point that is perpendicular to the <i>gradient line</i>.  The point's color is the color of the <i>gradient line</i> at the point where this line intersects it.</p>
 
 <!-- ====================================================================== -->
 
@@ -939,8 +939,8 @@ <h3 id='color-stop-syntax'>
 	at the beginning of the rule.  Color-stops must be specified in order.  
 	Percentages refer to the length of the gradient line, with 0% being at the 
 	starting point and 100% being at the ending point.  Lengths are measured 
-	from the starting-point in the direction of the ending-point.  Color-stops 
-	are usually placed between the starting-point and ending-point, but that's 
+	from the starting point in the direction of the ending point.  Color-stops
+	are usually placed between the starting point and ending point, but that's
 	not required; the gradient line extends infinitely in both directions, and 
 	a color-stop can be placed at any position on the line.</p>
 

css3-images/issues-lc-2012.txt

@@ -310,3 +310,8 @@ From:     David Baron
 Comment:  http://lists.w3.org/Archives/Public/www-style/2012Mar/0337.html
 Open.
 ----
+Issue 40.
+Summary:  Editorial comments on linear-gradient()
+From:     David Baron
+Comment:  http://lists.w3.org/Archives/Public/www-style/2012Mar/0338.html
+Open.