[css-fonts-4] Font shorthand: set explicitly, reset implicitly and cascade implicitly #7832

Author: svgeesus

css-fonts-4/Overview.bs

@@ -1509,6 +1509,11 @@ Shorthand font property: the 'font' property</h3>
 		variations/font-shorthand.html
 	</wpt>
 
+	The syntax of this property is based on a traditional
+	typographical shorthand notation
+	to set multiple properties related to fonts.
+	For historical and backwards-compatibility reasons,
+	it is <em>almost</em> a shorthand property.
 
 	The 'font!!property' property is,
 	except as described below,
@@ -1517,6 +1522,7 @@ Shorthand font property: the 'font' property</h3>
 	'font-weight!!property', 'font-stretch!!property',
 	'font-size!!property', 'line-height', 'font-family!!property'
 	at the same place in the stylesheet.
+
 	Values for the 'font-variant!!property' property can also be included
 	but only those supported in CSS 2.1;
 	none of the 'font-variant!!property' values added in
@@ -1537,30 +1543,63 @@ Shorthand font property: the 'font' property</h3>
 		  semi-condensed | semi-expanded | expanded | extra-expanded |
 		  ultra-expanded]</pre>
 
-	The syntax of this property is based on a traditional
-	typographical shorthand notation
-	to set multiple properties related to fonts.
+	Therefore we have the following classification 
+	of font-related properties 
+	and their interaction with the 'font!!property' property:
+
+	<dl>
+		<dt><dfn>Set Explicitly</dfn></dt>
+		<dd><p>These properties may be set using the 'font!!property' property:</p>
+			<ul>
+				<li>'font-family!!property'</li>
+				<li>'font-size!!property'</li>
+				<li>'font-stretch!!property' (css3)</li>
+				<li>'font-style!!property'</li>
+				<li>'font-variant-caps!!property' (css2)</li>
+				<li>'font-weight!!property'</li>
+				<li>'line-height'</li>
+			</ul>
+		</dd>
+		<dt><dfn>Reset Implicitly</dfn></dt>
+		<dd><p>These may not be set, but are reset to their initial values:</p>
+			<ul>
+				<li>'font-feature-settings!!property'</li>
+				<li>'font-kerning!!property'</li>
+				<li>'font-language-override!!property'</li>
+				<li>'font-optical-sizing!!property'</li>
+				<li>'font-size-adjust!!property'</li>
+				<li>'font-variant-alternates!!property'</li>
+				<li>'font-variant-caps!!property' (css3 and above)</li>
+				<li>'font-variant-east-asian!!property'</li>
+				<li>'font-variant-ligatures!!property'</li>
+				<li>'font-variant-numeric!!property'</li>
+				<li>'font-variant-position!!property'</li>
+				<li>'font-variation-settings!!property'</li>
+			</ul>
+		</dd>
+		<dt><dfn>Cascaded Independently</dfn></dt>
+		<dd><p>There are neither set nor reset by the 'font!!property' property:</p>
+			<ul>
+				<li>'font-palette!!property'</li>
+				<li>'font-synthesis-weight!!property'</li>
+				<li>'font-synthesis-style!!property'</li>
+				<li>'font-synthesis-caps!!property'</li>
+			</ul>
+		</dd>
+	</dl>
+
+	All subproperties of the 'font!!property' property
+	in the [=Set Explicitly=] and [=Reset Implicitly=] groups
+	are first reset
+	to their initial values.
 
-	All subproperties of the 'font!!property' property are first reset
-	to their initial values,
-	including those listed above
-	plus 'font-size-adjust', 'font-kerning',
-	all subproperties of 'font-variant!!property',
-	'font-feature-settings!!property',
-	'font-language-override!!property',
-	'font-optical-sizing',
-	'font-variation-settings!!property',
-	and 'font-palette'.
-	Then, those properties that are given explicit values
+	Then, those properties the [=Set Explicitly=] group
+	that are given explicit values
 	in the 'font!!property' shorthand
 	are set to those values.
 	For a definition of allowed and initial values,
 	see the previously defined properties.
-	For reasons of backwards compatibility,
-	it is not possible to set 'font-size-adjust'
-	to anything other than its initial value
-	using the 'font' shorthand property;
-	instead, use the individual property.
+
 
 	<div class="example" id="ex-font-shorthand">
 		<pre>