[[css-fonts-4] Define separate third type, system-font-family #9292

Author: svgeesus

css-fonts-4/Overview.bs

@@ -209,7 +209,7 @@ Font family: the 'font-family!!property' property</h3>
 	    then the generic font-family ''sans-serif'' font will be used.
 	</div>
 
-	There are two types of font family names:
+	There are three types of font family names, two of which may be used with this property:
 
 	<dl>
 	    <dt><dfn id="family-name-value"><<family-name>></dfn>
@@ -254,6 +254,34 @@ Font family: the 'font-family!!property' property</h3>
 
 	        The set of generic family keywords is defined in [[#generic-font-families]].
 
+		<dt><dfn id="system-family-name-value"><<system-family-name>></dfn>
+		<dd>
+			A locally installed system font, whose use is subject to certain constraints.
+			In particular, it may not be used with the ''font-family'' property,
+			but can be used with the ''font'' shorthand.
+
+			The following values refer to system fonts:
+
+			<dl dfn-type=value dfn-for=font>
+				<dt><dfn>caption</dfn>
+				<dd>The font used for captioned controls (e.g., buttons, drop-downs, etc.).
+				<dt><dfn>icon</dfn>
+				<dd>The font used to label icons.
+				<dt><dfn>menu</dfn>
+				<dd>The font used in menus (e.g., dropdown menus and menu lists).
+				<dt><dfn>message-box</dfn>
+				<dd>The font used in dialog boxes.
+				<dt><dfn>small-caption</dfn>
+				<dd>The font used for labeling small controls.
+				<dt><dfn>status-bar</dfn>
+				<dd>The font used in window status bars.
+			</dl>
+
+	<wpt>
+		system-fonts-serialization.tentative.html
+	</wpt>
+		</dd>
+
 	</dl>
 
 <h4 id="family-name-syntax">
@@ -262,13 +290,14 @@ Syntax of <<family-name>>
 
 	<pre class=prod><l><<family-name>></l> = <<string>> | <<custom-ident>>+</pre>
 
-	Font family names other than generic families must either be given quoted as <<string>>s,
+	Font family names other than generic families or system font families 
+	must either be given quoted as <<string>>s,
 	or unquoted as a sequence of one or more <<custom-ident>>.
 
 	Note: This means most punctuation characters and digits at the start of
 	each token must be escaped in unquoted font family names.
 
-	<div class="example" id="ex-no-unquoted-punctuation">
+	<div class="example invalid" id="ex-no-unquoted-punctuation">
 	    To illustrate this, the following declarations are invalid:
 
 	    <pre>
@@ -290,8 +319,9 @@ Syntax of <<family-name>>
 	Note: this means that if you really have a font
 	whose name
 	is the same as one of the <<generic-family>> names,
+	or the system font names,
 	or the [=CSS-wide keywords=],
-	it must be quoted.
+	it <em>must</em> be quoted.
 
 	<div class="example" id="ex-valid-unusual-generic-like">
 			To illustrate this,
@@ -354,6 +384,14 @@ Syntax of <<generic-family>>
 		The third is a generic font, which is guaranteed to match on all systems.
 	</div>
 
+<h4 id="system">
+Syntax of <<system-family-name>>	
+</h4>
+
+	<pre class="prod">
+		<l><<system-family-name>></l> = caption | icon | menu | message-box | small-caption | status-bar
+	</pre>
+
 <h4 id="font-families">
 Relationship Between Faces and Families
 </h4>
@@ -1542,8 +1580,9 @@ Shorthand font property: the 'font' property</h3>
 	Value: [ [ <<'font-style'>> ||
 		<<font-variant-css2>> ||
 		<<'font-weight'>> ||
-		<<font-stretch-css3>> ]? <<'font-size'>> [ / <<'line-height'>> ]? <<'font-family'>> ] |
-		caption | icon | menu | message-box | small-caption | status-bar
+		<<font-stretch-css3>> ]? <<'font-size'>> [ / <<'line-height'>> ]? 
+		<<'font-family'>> ] | 
+		<<'system-family-name'>>
 	Initial: see individual properties
 	Applies to: all elements and text
 	Inherited: yes
@@ -1718,26 +1757,6 @@ Shorthand font property: the 'font' property</h3>
 		}
 	</pre>
 
-	The following values refer to system fonts:
-
-	<dl dfn-type=value dfn-for=font>
-		<dt><dfn>caption</dfn>
-		<dd>The font used for captioned controls (e.g., buttons, drop-downs, etc.).
-		<dt><dfn>icon</dfn>
-		<dd>The font used to label icons.
-		<dt><dfn>menu</dfn>
-		<dd>The font used in menus (e.g., dropdown menus and menu lists).
-		<dt><dfn>message-box</dfn>
-		<dd>The font used in dialog boxes.
-		<dt><dfn>small-caption</dfn>
-		<dd>The font used for labeling small controls.
-		<dt><dfn>status-bar</dfn>
-		<dd>The font used in window status bars.
-	</dl>
-
-	<wpt>
-		system-fonts-serialization.tentative.html
-	</wpt>
 
 	System fonts can only be set as a whole;
 	that is, the font family, size, weight, style, etc.