add appendix to describe DOM interfaces

Author: John Daggett

css3-fonts/Fonts.html

@@ -111,14 +111,14 @@
 
    <h1>CSS Fonts Module Level 3</h1>
 
-   <h2 class="no-num no-toc" id=editors>Editor's Draft 23 September 2011</h2>
+   <h2 class="no-num no-toc" id=editors>Editor's Draft 26 September 2011</h2>
 
    <dl id=authors>
     <dt>This version:
 
     <dd><a
      href="http://dev.w3.org/csswg/css3-fonts/">http://dev.w3.org/csswg/css3-fonts/</a>
-     <!-- <dd><a href="http://www.w3.org/TR/2011/ED-css3-fonts-20110923">http://www.w3.org/TR/2011/ED-css3-fonts-20110923</a> -->
+     <!-- <dd><a href="http://www.w3.org/TR/2011/ED-css3-fonts-20110926">http://www.w3.org/TR/2011/ED-css3-fonts-20110926</a> -->
 
 
     <dt>Latest version:
@@ -368,6 +368,9 @@ <h2 class="no-num no-toc" id=contents>Table of contents</h2>
    <li class=no-num><a href="#font-licensing">Appendix B: Font licensing
     issues</a>
 
+   <li class=no-num><a href="#font-feature-values-DOM">Appendix C: DOM
+    Interfaces</a>
+
    <li class=no-num><a href="#ch-ch-ch-changes">Changes</a>
     <ul class=toc>
      <li class=no-num><a href="#recent-changes"> Changes from the June 2009
@@ -4091,6 +4094,9 @@ <h3 id=font-feature-values><span class=secno>6.9 </span>Defining font
   font-variant-alternates: character-variant(beta-3, gamma);
 }</pre>
 
+  <p>See <a href="#font-feature-values-DOM">Appendix C</a> for a description
+   of the interfaces used to modify these rules via the CSS Object Model.
+
   <div class=figure><img alt="Matching text on Byzantine seals using
    character variants" src=byzantineseal.png>
    <p class=caption>Byzantine seal text displayed with character variants
@@ -4786,6 +4792,99 @@ <h2 class=no-num id=font-licensing>Appendix B: Font licensing issues</h2>
     use Gentium as a downloadable font for their web pages.</p>
   </div>
 
+  <h2 class=no-num id=font-feature-values-DOM>Appendix C: DOM Interfaces</h2>
+
+  <p><em>This appendix is normative.</em>
+
+  <p>Font feature values defined within <code>@font-feature-values</code>
+   rules are accessible via the following modifications to the CSS Object
+   Model.
+
+  <dl>
+   <dt><b>Interface <i><a id=DOM-CSSRule name=DOM-CSSRule>CSSRule</a></i></b>
+
+   <dd>
+    <p>The following additional rule type is added to the
+     <code>CSSRule</code> interface.</p>
+
+    <dl>
+     <dt><b>IDL Definition</b>
+
+     <dd>
+      <div class=idl-code>
+       <pre>
+interface CSSRule {
+...
+const unsigned short FONT_FEATURE_VALUES_RULE = 11;
+...
+};</pre>
+      </div>
+     </dd>
+     <!-- IDL -->
+    </dl>
+
+   <dt><b>Interface <i><a id=DOM-CSSFontFeatureValuesRule
+    name=DOM-CSSFontFeatureValuesRule>CSSFontFeatureValuesRule</a></i></b>
+
+   <dd>
+    <p> The <code>CSSFontFeatureValuesRule</code> interface represents font
+     feature selector values for a given set of font families.</p>
+
+    <dl>
+     <dt> <br>
+      <b>IDL Definition</b>
+
+     <dd>
+      <div class=idl-code>
+       <pre>
+interface CSSFontFeatureValuesRule : CSSRule {
+  attribute DOMString fontFamily;
+                        // raises(DOMException) on setting
+  attribute DOMString valueText;
+                        // raises(DOMException) on setting
+};
+</pre>
+      </div>
+      <br>
+
+     <dt><b>Attributes</b>
+
+     <dd>
+      <dl>
+       <dt><code class=attribute-name><a
+        id=DOM-CSSFontFeatureValuesRule-fontFamily
+        name=DOM-CSSFontFeatureValuesRule-fontFamily>fontFamily</a></code> of
+        type <code>DOMString</code>
+
+       <dd>This attribute represents the list of font families for which a
+        particular set of values are defined. The syntax is the same as that
+        of the font-family property.
+      </dl>
+
+     <dd>
+      <dl>
+       <dt><code class=attribute-name><a
+        id=DOM-CSSFontFeatureValuesRule-valueText
+        name=DOM-CSSFontFeatureValuesRule-valueText>valueText</a></code> of
+        type <code>DOMString</code>
+
+       <dd>Parsable text representing the set of feature values defined for a
+        given set of font families.
+      </dl>
+
+     <dt><b>Exceptions on setting</b>
+    </dl>
+
+    <dl>
+     <dt><code>DOMException SYNTAX_ERR</code>
+
+     <dd>Thrown when the specified string value has a syntax error or is
+      unparsable.
+    </dl>
+
+   <dt><b>No Methods</b>
+  </dl>
+
   <h2 class=no-num id=ch-ch-ch-changes>Changes</h2>
 
   <h3 class=no-num id=recent-changes> Changes from the <a