[css-backgrounds-3] Restore text deleted in 99928ab goddamit Tab review your 'fix markup' diffs #4667

Author: fantasai

css-backgrounds-3/Overview.bs

@@ -1030,6 +1030,14 @@ there is a second step. The UA must scale the image in that dimension
 the background positioning area. In the case of the width (height is
 analogous):
 
+<blockquote>
+  <p>If <var>X</var> &ne; 0 is the width of the image after step one
+  and <var>W</var> is the width of the background positioning area,
+  then the rounded width
+  <var>X'</var> = <var>W</var> / round(<var>W</var> / <var>X</var>)
+  where round() is a function that returns the nearest natural number
+  (integer greater than zero).
+</blockquote>
 
 <p>If 'background-repeat' is ''background-repeat/round'' for one dimension only and if
 'background-size' is ''background-size/auto'' for the other dimension, then there is a third
@@ -2610,7 +2618,8 @@ inline tables that have 'border-collapse' set to
 ''border-collapse/collapse''. However, this specification does not define how such an
 image border is rendered. In particular, it does not define how the
 image border interacts with the borders of cells, rows and row groups
-at the edges of the table (see <a href="https://www.w3.org/TR/2011/REC-CSS2-20110607/tables.html#border-conflict-resolution">border conflict resolution</a> in [[!CSS2]]).
+at the edges of the table
+(see <a href="https://www.w3.org/TR/2011/REC-CSS2-20110607/tables.html#border-conflict-resolution">border conflict resolution</a> in [[!CSS2]]).
 
 <p>It is expected that a future specification will define the
 rendering. It is recommended that UAs do not apply border images to
@@ -2982,6 +2991,29 @@ Changes</h2>
 Changes since the 17 October 2017 Candidate Recommendation</h3>
 
 <ul>
+  <li>
+    Inverted order of <<shadow>> grammar to match browser serialization and 'text-shadow'/''drop-shadow()''.
+      (<a href="https://github.com/w3c/csswg-drafts/issues/2305">Issue 2305</a>)
+      <blockquote>
+        <pre><<shadow>> = <del>inset</del><ins><<color>></ins>? &amp;&amp; <<length>>{2,4} &amp;&amp; <del><<color>></del><ins>inset</ins>?</pre>
+      </blockquote>
+  <li>
+    Spread radius adjustment is only applied to outer shadows (and positive margins)--
+    i.e. cases where the radius of curvature grows, rather than shrinks.
+    (<a href="https://github.com/w3c/csswg-drafts/issues/1900">Issue 1900</a>)
+      <blockquote>
+        <p>To preserve the box's shape when spread is applied,
+        the corner radii of the shadow are also increased (decreased, for inner shadows)
+        from the border-box radii by adding (subtracting)
+        the <i>spread distance</i> (and flooring at zero).
+        However, in order to create a sharper corner when the border radius is small
+        <ins>(and thus ensure continuity between round and sharp corners)</ins>,
+        when the <i>border radius</i> is less than the <i>spread distance</i>,
+        the <i>spread distance</i> <ins>of an outer shadow</ins>
+        is multiplied by the proportion 1 + (<var>r</var>-1)<sup>3</sup>,
+        where <var>r</var> is the ratio of the border radius to the <i>spread distance</i>,
+        in calculating the corner radii of the spread shadow shape.
+      </blockquote>
   <li>
     Clarified that an omitted <<color>> in a <<shadow>> defaults to ''currentColor'',
     not some mysterious unnamed value with the same behavior.
@@ -3106,6 +3138,113 @@ Changes Since the 15 February 2011 Candidate Recommendation</h3>
 <a href="https://www.w3.org/TR/2011/CR-css3-background-20110215/">15 February 2011
 Candidate Recommendation</a>:
 
+<ul>
+  <li><a href="#the-background-size">Section 3.9</a>:
+    Defined what happens if 'background-size' has two ''background-size/auto'' values
+    and the image is missing an intrinsic dimension.
+    <blockquote>
+    <p>If both values are ''background-size/auto'' then the intrinsic width and/or
+    height of the image should be used, if any<ins>, the missing
+    dimension (if any) behaving as ‘auto’ as described above</ins>.
+    </blockquote>
+  <li><a href="#corner-transitions">Section 5.4</a>:
+    Made center of <a href="#corner-transitions">color and style transitions</a>
+    undefined (within certain limits) on corner joins, since previous definition
+    was wrong.
+    <blockquote>
+    <p><del>The center of color and style transitions between
+    adjoining borders is at the point on the curve that is at an angle
+    that is proportional to the ratio of the border widths. For
+    example, if the top and right border widths are equal, that point
+    is at a 45° angle from the horizontal, and if the top is twice the
+    width of the right the point is at a 30° angle from the
+    horizontal. The line demarcating this transition is drawn between
+    the point at that angle on the outer arc and the point at that
+    angle on the inner arc.</del>
+    <p><ins>If one of these borders is zero-width, then the other
+    border takes up the entire transitional area. Otherwise, the
+    center of color and style transitions between adjoining borders
+    must be proportional to the ratio of the border widths such that a
+    function of its location is continuous with respect to this ratio.
+    However it is not defined what these transitions look like or how
+    &ldquo;proportional&rdquo; maps to a point on the curve.</ins>
+    </blockquote>
+  <li><a href="#the-border-image-slice">Section 6.2</a>:
+    Defined <a href="#the-border-image-slice">slicing of border images</a>
+    that must be sized first to determine slice positions.
+    Added:
+    <blockquote>
+    <p><ins>If the image must be sized to determine the slices (for
+    example, for SVG images with no intrinsic size), then it is sized
+    as for an auto-sized background, using the border image area as
+    the default object size in place of the background positioning
+    area.</ins>
+    </blockquote>
+  <li><a href="#misc">Section 7.1</a>
+    Optionally added bidi-imposed breaks to the types of breaks affected by
+      'box-decoration-break'.
+    Added:
+    <blockquote>
+    <p><ins>UAs may also apply ‘box-decoration-break’ to control
+    rendering at bidi-imposed breaks, i.e. when bidi reordering causes
+    an inline to split into non-contiguous fragments. Otherwise such
+    breaks are always handled as ‘slice’.</ins>
+    </blockquote>
+  <li><a href="#the-box-shadow">Section 7.2</a>:
+    Defined the default color of 'box-shadow'.
+    <blockquote>
+    <p>The color is the color of the shadow. <ins>If the color is
+    absent, the used color is taken from the ‘color’ property.</ins>
+    </blockquote>
+  <li><a href="#the-background-position">Section 3.6</a>:
+    Clarified computed value of 'background-position'.
+    <blockquote>
+    <p><del>If one or two values are specified, for a &lt;length> the
+    absolute length, otherwise a percentage. If three or four values
+    are specified, two pairs of a keyword plus a length or
+    percentage.</del> <ins>Two keywords representing the origin and
+    two offsets from that origin, each given as an absolute length (if
+    given a <<length>>), otherwise as a percentage.</ins>
+    </blockquote>
+    <p>Changed <del>Equivalent</del> to <ins>Computes</ins> in
+    definition of keywords.
+  <li><a href="#animations">Section 2.3</a> (and all property definitions):
+    Added a section about expected an expected animations module.
+    Added "Animatable" line to property definition tables.
+  <li><a href="#the-background-position">Section 3.6</a>:
+    Renamed &lt;bg-position&gt; production to <i>&lt;position&gt;</i> for
+    easier re-use in other specifications and recast the grammar to be more
+    verbose but easier to understand.
+    <blockquote>
+    <pre class=prod>
+      <del>bg-position</del><ins>&lt;position&gt;</ins> = [
+        [ <ins>left | center | right |</ins> top | bottom <ins>| <<length-percentage>></ins> ]
+      |
+        [ left | center | right | <<length-percentage>> ]
+        [ top | center | bottom | <<length-percentage>> ]<del>?</del>
+      |
+        [ center | [ left | right ] <<length-percentage>>? ] &amp;&amp;
+        [ center | [ top | bottom ] <<length-percentage>>? ]
+      ]
+    </pre>
+    </blockquote>
+  <li><a href="#the-border-image-repeat">Section 6.5</a>:
+    Added ''border-image-repeat/space'' keyword to 'border-image-repeat' property value table:
+    it was included in the list of allowable values, but not in the syntax
+    definition.
+    <blockquote>
+    <p>[ stretch | repeat | round <ins>| space</ins> ]{1,2}
+    </blockquote>
+  <li><a href="#corner-overlap">Section 5.5</a>:
+    Corrected math error in border-radius example.
+    <blockquote>
+    <p>The height (2.5em) is enough for the specified radii (0.5em
+    plus <del>2.5em</del> <ins>2.0em</ins>).
+    </blockquote>
+  <li><a href="#the-border-width">Section 4.3</a>:
+    Marked Percentages field as N/A for 'border-width', since they are not
+    included in the property.
+</ul>
 
 <h3 id="changes-2009">
 Changes Since the 17 December 2009 Candidate Recommendation</h3>