ideas/radial-gradients: [Radial Gradient Wars]

Author: bkemper

ideas/radial-gradients.txt

@@ -87,14 +87,14 @@ The 'circle' keyword sets the intrinsic ratio of the image to 1:1.
   * Differences with similar-looking background syntax:
     * radial-gradient uses a comma instead of a slash to disambiguate between position and size,
     * the size values are for a quarter of the image size, not the whole image size,
-    * the explicit size doesn't give the image implicit dimensions,
     * the positioning lengths and keywords apply to the center of the gradient, instead of to the top left (and percentage offsets are even more different),
     * the positioning values move the whole gradient and then clip it to the image dimensions.
+  * the explicit size doesn't give the image implicit dimensions,
   * Two gradient lines (horizontal and vertical radii) instead of one (unless using 'circle' keyword). No getting around this in either syntax.
   * Percentages are relative to both dimensions, fixed distances measured against horizontal only. This is in simplified syntax too.
     * Even though the spec says “The gradient-ray is anchored at the center of the gradient and extends toward the right”, fixed distance color stops can just as easily be measured from center to left, since all the gradients are symetrical.
   * If you want to use an explicit size, you must include the <bg-position> part too (so that the comma will disambiguate).
-'closest-corner' and 'farthest-corner' are the same if there is no <bg-position> .
+  * 'closest-corner' and 'farthest-corner' are the same if there is no <bg-position> .
 moving the center via <bg-position> does not move it relative to the whole ellipse, it moves the entire ellipse. This means the gradient gets bigger if you have 'cover' or 'farthest-*', and smaller if you have 'contain' or 'closest-*'.
   * If you specify a <bg-position> and a <size> keyword, the positioning happens first. This means that the positioning affects the gradient length, then the sizing keyword changes it to something else. If these were done is the opposite order, then only the <size> would affect the gradient length (but it would be harder to get the image filled in useful and common ways).
   * Conversely, if you specify a <bg-position> and an explicit size, the size overrides the effect of positioning on gradient length.