[css-text-decor-4] Clean up text-decoration-* descriptions. (Editorial.)

Author: fantasai

css-text-decor-4/Overview.bs

@@ -179,8 +179,19 @@ Text Decoration Lines: the 'text-decoration-line' property</h3>
 	Animation type: discrete
 	</pre>
 
-	Specifies what line decorations, if any, are added to the element.
-	Values have the following meanings:</p>
+	This property,
+	which is a <a>sub-property</a> of the 'text-decoration' shorthand,
+	specifies what line decorations, if any, are added by the element.
+	Values other than ''text-decoration-line''
+	cause the element to originate the indicated text decorations,
+	and to apply and propagate it as described [[#line-decoration|above]].
+
+	Note: Unless it is desired for the color, style, and thickness of the lines
+	to be set by declarations lower in the [=cascade=],
+	it is safer to use the 'text-decoration' [=shorthand=]
+	instead of this [=longhand=].
+
+	Values have the following meanings:
 
 	<dl dfn-type=value dfn-for=text-decoration-line>
 		<dt><dfn>none</dfn>
@@ -256,15 +267,16 @@ Text Decoration Style: the 'text-decoration-style' property</h3>
 	Animation type: discrete
 	</pre>
 
-	This property specifies the style of the line(s) drawn for
-	text decoration specified on the element. Values have the
-	same meaning as for the
-	<a href="https://www.w3.org/TR/css-backgrounds-3/#the-border-style">border-style
-	properties</a> [[!CSS-BACKGROUNDS-3]]. ''wavy'' indicates a wavy line.
-
-	The style of text decorations must remain the same on all decorations originating from a given element,
-	even if descendant boxes have different specified styles.
+	This property,
+	which is a <a>sub-property</a> of the 'text-decoration' shorthand,
+	sets the line-drawing style of underlines, overlines, and line-throughs
+	specified on the element with 'text-decoration-line',
+	and affects all decorations originating from this element
+	even if descendant boxes specify a different style.
 
+	Values have the same meaning as for the
+	<a href="https://www.w3.org/TR/css-backgrounds-3/#the-border-style">border-style properties</a> [[!CSS-BACKGROUNDS-3]].
+	<dfn type=value for=text-decoration-style>wavy</dfn> indicates a wavy line.
 
 <h3 id="text-decoration-color-property">
 Text Decoration Color: the 'text-decoration-color' property</h3>
@@ -278,12 +290,12 @@ Text Decoration Color: the 'text-decoration-color' property</h3>
 	Animation type: by computed value type
 	</pre>
 
-	This property specifies the color of text decoration (underlines
-	overlines, and line-throughs) set on the element with
-	'text-decoration-line'.
-
-	The color of text decorations must remain the same on all decorations originating from a given element,
-	even if descendant boxes have different specified colors.
+	This property,
+	which is a <a>sub-property</a> of the 'text-decoration' shorthand,
+	sets the color of underlines, overlines, and line-throughs
+	specified on the element with 'text-decoration-line',
+	and affects all decorations originating from this element
+	even if descendant boxes specify a different color.
 
 <h3 id="text-decoration-width-property">
 Text Decoration Line Thickness: the 'text-decoration-thickness' property</h3>
@@ -299,8 +311,12 @@ Text Decoration Line Thickness: the 'text-decoration-thickness' property</h3>
 	Animation type: by computed value
 	</pre>
 
-	This property, which is also a <a>sub-property</a> of the 'text-decoration' shorthand,
-	sets the stroke thickness of underlines, overlines, and line-throughs.
+	This property,
+	which is a <a>sub-property</a> of the 'text-decoration' shorthand,
+	sets the stroke thickness of underlines, overlines, and line-throughs
+	specified on the element with 'text-decoration-line',
+	and affects all decorations originating from this element
+	even if descendant boxes specify a different thickness.
 
 	Values have the following meanings:
 
@@ -447,7 +463,10 @@ Text Decoration Shorthand: the 'text-decoration' property</h3>
 	</pre>
 
 	This property is a shorthand for setting
-	'text-decoration-line',	'text-decoration-thickness', 'text-decoration-style', and 'text-decoration-color'
+	'text-decoration-line',
+	'text-decoration-thickness',
+	'text-decoration-style',
+	and 'text-decoration-color'
 	in one declaration.
 	Omitted values are set to their initial values.
 
@@ -486,8 +505,12 @@ Text Underline Position: the 'text-underline-position' property</h3>
 	Animation type: discrete
 	</pre>
 
-	This property sets the position of an underline with respect to the element,
-	and sets its [=zero position=] for further adjustment by 'text-underline-offset'.
+	This property,
+	which is <em>not</em> a <a>sub-property</a> of the 'text-decoration' shorthand,
+	sets the position of an underline with respect to the text,
+	and defines its [=zero position=] for further adjustment by 'text-underline-offset'.
+	It affects all decorations originating from this element,
+	even if descendant boxes specify a different position.
 	It does not affect underlines specified by ancestor elements.
 
 	<div class="example">
@@ -623,10 +646,14 @@ Text Underline Offset: the 'text-underline-offset' property</h3>
 	Animation type: by computed value
 	</pre>
 
-	This property, which is <em>not</em> a <a>sub-property</a> of the 'text-decoration' shorthand,
+	This property,
+	which is <em>not</em> a <a>sub-property</a> of the 'text-decoration' shorthand,
 	sets the offset of underlines from their [=zero position=].
 	Positive offsets represent distances outward from the text;
 	negative offsets inward.
+	It affects all decorations originating from this element,
+	even if descendant boxes specify a different position.
+	It does not affect underlines specified by ancestor elements.
 
 	Values have the following meanings: