[css-font-loading] Actually specify how to parse the FontFace descriptors.

Author: tabatkins

css-font-loading/Overview.bs

@@ -107,6 +107,13 @@ The <code>FontFace</code> Interface</h2>
 			<em>represents</em> an italic font face;
 			it does not <strong>make</strong> the font face italic.
 
+			On getting, return the string associated with this attribute.
+
+			On setting, parse the string according to the grammar for the CSS ''@font-face'' rule.
+			If it does not match the grammar,
+			throw a TypeError;
+			otherwise, set the attribute to the provided string.
+
 		<dt><dfn>variant</dfn>, <span attribute-info for=variant></span>
 		<dt><dfn>featureSettings</dfn>, <span attribute-info for=featureSettings></span>
 		<dd>
@@ -118,6 +125,13 @@ The <code>FontFace</code> Interface</h2>
 			Unlike the previous attributes,
 			these attributes actually affect the font face.
 
+			On getting, return the string associated with this attribute.
+
+			On setting, parse the string according to the grammar for the CSS ''@font-face'' rule.
+			If it does not match the grammar,
+			throw a TypeError;
+			otherwise, set the attribute to the provided string.
+
 		<dt><dfn>status</dfn>, <span attribute-info for=FontFace/status></span>
 		<dd>
 			This attribute reflects the current status of the font face.

css-font-loading/Overview.html

@@ -54,12 +54,12 @@
 </p>
   <h1 class="p-name no-ref" id=title>CSS Font Loading Module Level 3</h1>
   <h2 class="no-num no-toc no-ref heading settled heading" id=subtitle><span class=content>Editor’s Draft,
-    <span class=dt-updated><span class=value-title title=20140616>16 June 2014</span></span></span></h2>
-  <div data-fill-with=spec-metadata><dl><dt>This version:<dd><a class=u-url href=http://dev.w3.org/csswg/css-font-loading/>http://dev.w3.org/csswg/css-font-loading/</a><dt>Latest version:<dd><a href=http://w3.org/TR/css-font-loading/>http://w3.org/TR/css-font-loading/</a><dt>Editor’s Draft:<dd><a href=http://dev.w3.org/csswg/css-font-loading/>http://dev.w3.org/csswg/css-font-loading/</a><dt>Previous Versions:<dd><a href=http://www.w3.org/TR/2014/WD-css-font-loading-3-20140522/ rel=previous>http://www.w3.org/TR/2014/WD-css-font-loading-3-20140522/</a>
+    <span class=dt-updated><span class=value-title title=20140622>22 June 2014</span></span></span></h2>
+  <div data-fill-with=spec-metadata><dl><dt>This version:<dd><a class=u-url href=http://dev.w3.org/csswg/css-font-loading/>http://dev.w3.org/csswg/css-font-loading/</a><dt>Latest version:<dd><a href=http://w3.org/TR/css-font-loading/>http://w3.org/TR/css-font-loading/</a><dt>Previous Versions:<dd><a href=http://www.w3.org/TR/2014/WD-css-font-loading-3-20140522/ rel=previous>http://www.w3.org/TR/2014/WD-css-font-loading-3-20140522/</a>
     <dt>Feedback:</dt>
         <dd><a href="mailto:www-style@w3.org?subject=%5Bcss-font-loading%5D%20feedback">www-style@w3.org</a>
             with subject line
-            “<kbd>[css-font-loading] <var>… message topic …</var></kbd>”(<a href=http://lists.w3.org/Archives/Public/www-style/ rel=discussion>archives</a>)<dt>Test Suite:<dd>None Yet<dt>Editors:
+            “<kbd>[css-font-loading] <var>… message topic …</var></kbd>”(<a href=http://lists.w3.org/Archives/Public/www-style/ rel=discussion>archives</a>)<dt>Editors:
 <dd class="p-author h-card vcard"><a class="p-name fn u-url url" href=http://xanthir.com/contact/>Tab Atkins Jr.</a> (<span class="p-org org">Google</span>)<dt>Former Editors:
 <dd class="p-author h-card vcard"><a class="p-name fn u-email email" href=mailto:jdaggett@mozilla.com>John Daggett</a> (<span class="p-org org">Mozilla</span>)</dl></div>
   <div data-fill-with=warning></div>
@@ -69,7 +69,8 @@ <h2 class="no-num no-toc no-ref heading settled heading" id=subtitle><span class
 </div>
 
 <h2 class="no-num no-toc no-ref heading settled heading" id=abstract><span class=content>Abstract</span></h2>
-<p class=p-summary data-fill-with=abstract>This CSS module describes events and interfaces used for dynamically loading font resources.
+<p class=p-summary data-fill-with=abstract><p>This CSS module describes events and interfaces used for dynamically loading font resources.</p>
+
 <a href=http://www.w3.org/TR/CSS/>CSS</a> is a language for describing the rendering of structured documents 
 (such as HTML and XML) 
 on screen, on paper, in speech, etc.</p>
@@ -231,6 +232,13 @@ <h2 class="heading settled heading" data-level=2 id=fontface-interface><span cla
 			<em>represents</em> an italic font face;
 			it does not <strong>make</strong> the font face italic.</p>
 
+<p>On getting, return the string associated with this attribute.</p>
+
+<p>On setting, parse the string according to the grammar for the CSS <a class=css data-link-type=maybe href=http://dev.w3.org/csswg/css-fonts-3/#at-font-face-rule title=@font-face>@font-face</a> rule.
+			If it does not match the grammar,
+			throw a TypeError;
+			otherwise, set the attribute to the provided string.</p>
+
 		<dt><dfn class=idl-code data-dfn-for=FontFace data-dfn-type=attribute data-export="" id=dom-fontface-variant>variant<a class=self-link href=#dom-fontface-variant></a></dfn>, <span data-attribute-info="" for=variant> of type <a data-link-type=idl-name title=domstring>DOMString</a></span>
 		<dt><dfn class=idl-code data-dfn-for=FontFace data-dfn-type=attribute data-export="" id=dom-fontface-featuresettings>featureSettings<a class=self-link href=#dom-fontface-featuresettings></a></dfn>, <span data-attribute-info="" for=featureSettings> of type <a data-link-type=idl-name title=domstring>DOMString</a></span>
 		<dd>
@@ -242,6 +250,13 @@ <h2 class="heading settled heading" data-level=2 id=fontface-interface><span cla
 			Unlike the previous attributes,
 			these attributes actually affect the font face.</p>
 
+<p>On getting, return the string associated with this attribute.</p>
+
+<p>On setting, parse the string according to the grammar for the CSS <a class=css data-link-type=maybe href=http://dev.w3.org/csswg/css-fonts-3/#at-font-face-rule title=@font-face>@font-face</a> rule.
+			If it does not match the grammar,
+			throw a TypeError;
+			otherwise, set the attribute to the provided string.</p>
+
 		<dt><dfn class=idl-code data-dfn-for=FontFace data-dfn-type=attribute data-export="" id=dom-fontface-status>status<a class=self-link href=#dom-fontface-status></a></dfn>, <span data-attribute-info="" for=FontFace/status> of type <a data-link-type=idl-name href=#enumdef-fontfaceloadstatus title=fontfaceloadstatus>FontFaceLoadStatus</a>, readonly</span>
 		<dd>
 			This attribute reflects the current status of the font face.