rework font-synthesis

Author: John Daggett

css3-fonts/Fonts.html

@@ -111,15 +111,15 @@
 
    <h1>CSS Fonts Module Level 3</h1>
 
-   <h2 class="no-num no-toc" id=editors-draft-7-march-2011>Editor's Draft 7
+   <h2 class="no-num no-toc" id=editors-draft-8-march-2011>Editor's Draft 8
     March 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-20110307">http://www.w3.org/TR/2011/ED-css3-fonts-20110307</a> -->
+     <!-- <dd><a href="http://www.w3.org/TR/2011/ED-css3-fonts-20110308">http://www.w3.org/TR/2011/ED-css3-fonts-20110308</a> -->
 
 
     <dt>Latest version:
@@ -258,9 +258,8 @@ <h2 class="no-num no-toc" id=contents>Table of contents</h2>
      <li><a href="#font-prop"><span class=secno>3.7 </span>Shorthand font
       property: the font property</a>
 
-     <li><a href="#font-synthetic-prop"><span class=secno>3.8
-      </span>Controlling synthetic faces: the font-weight-synthetic and
-      font-style-synthetic properties</a>
+     <li><a href="#font-synthesis-prop"><span class=secno>3.8
+      </span>Controlling synthetic faces: the font-synthesis property</a>
     </ul>
 
    <li><a href="#font-resources"><span class=secno>4 </span>Font
@@ -908,10 +907,10 @@ <h3 id=font-weight-prop><span class=secno>3.2 </span>Font weight: the <a
     faces
   </div>
 
-  <p>Although not well-loved by typographers, bold faces are often
-   synthesized by user agents for faces that lack actual bold faces. For the
-   purposes of style matching, these faces must be treated as if they exist
-   within the family.
+  <p>Although the practice is not well-loved by typographers, bold faces are
+   often synthesized by user agents for faces that lack actual bold faces.
+   For the purposes of style matching, these faces must be treated as if they
+   exist within the family.
 
   <p>Values of ‘<code class=property>bolder</code>’ and ‘<code
    class=property>lighter</code>’ indicate values relative to the weight of
@@ -1818,72 +1817,28 @@ <h3 id=font-prop><span class=secno>3.7 </span>Shorthand font property: the
 } 
 </pre>
   </div>
-  <!-- prop: font-weight-synthetic, font-style-synthetic -->
+  <!-- prop: font-synthesis -->
 
-  <h3 id=font-synthetic-prop><span class=secno>3.8 </span>Controlling
-   synthetic faces: the <a
-   href="#propdef-font-weight-synthetic">font-weight-synthetic</a> and <a
-   href="#propdef-font-style-synthetic">font-style-synthetic</a> properties</h3>
-
-  <table class=propdef id=namefont-weight-syntheticvalueauto-none->
-   <tbody>
-    <tr>
-     <td>Name:
-
-     <td><dfn id=propdef-font-weight-synthetic>font-weight-synthetic</dfn>
-
-    <tr>
-     <td>Value:
-
-     <td>auto | none | inherit
-
-    <tr>
-     <td>Initial:
-
-     <td>auto
-
-    <tr>
-     <td>Applies to:
-
-     <td>all elements
-
-    <tr>
-     <td>Inherited:
-
-     <td>yes
-
-    <tr>
-     <td>Percentages:
-
-     <td>N/A
-
-    <tr>
-     <td>Media:
-
-     <td>visual
-
-    <tr>
-     <td>Computed value:
-
-     <td>as specified
-  </table>
+  <h3 id=font-synthesis-prop><span class=secno>3.8 </span>Controlling
+   synthetic faces: the <a href="#propdef-font-synthesis">font-synthesis</a>
+   property</h3>
 
-  <table class=propdef id=namefont-style-syntheticvalueauto-none-i>
+  <table class=propdef id=namefont-synthesisvaluenone-weight-style>
    <tbody>
     <tr>
      <td>Name:
 
-     <td><dfn id=propdef-font-style-synthetic>font-style-synthetic</dfn>
+     <td><dfn id=propdef-font-synthesis>font-synthesis</dfn>
 
     <tr>
      <td>Value:
 
-     <td>auto | none | inherit
+     <td>none | [ weight || style ]
 
     <tr>
      <td>Initial:
 
-     <td>auto
+     <td>weight style
 
     <tr>
      <td>Applies to:
@@ -1911,17 +1866,18 @@ <h3 id=font-synthetic-prop><span class=secno>3.8 </span>Controlling
      <td>as specified
   </table>
 
-  <p>These properties control whether user agents are allowed to synthetize
-   bold or synthetic oblique font faces when a font family lacks bold or
-   italic faces. For each of these properties the default value of ‘<code
-   class=property>auto</code>’ allows user agents to use synthetic versions
-   of font faces while a value of ‘<code class=property>none</code>’
-   disallows the use of synthetic versions.
+  <p>This property controls whether user agents are allowed to synthesize
+   bold or oblique font faces when a font family lacks bold or italic faces.
+   If ‘<code class=property>weight</code>’ is not specified, user agents
+   must not synthesize bold faces and if ‘<code
+   class=property>style</code>’ is not specified user agents must not
+   synthesize italic faces. A value of ‘<code class=property>none</code>’
+   disallows all synthetic faces.
 
   <div class=example>
    <p>The style rule below diables the use of synthetically obliqued Arabic:</p>
 
-   <pre>*:lang(ar) { font-style-synthetic: none; }
+   <pre>*:lang(ar) { font-synthesis: none; }
 </pre>
   </div>
 
@@ -3143,8 +3099,8 @@ <h3 id=vertical-position-prop><span class=secno>6.4 </span>Subscript,
    subscripts and superscripts, when the value is either ‘<code
    class=property>subscript</code>’ or ‘<code
    class=property>superscript</code>’, the property acts as a shorthand and
-   resets the value of the font-size and vertical-align properties to
-   ‘<code class=property>inherit</code>’. Other than this, the property
+   resets the value of font-size to ‘<code class=property>inherit</code>’
+   and vertical-align to its initial value. Other than this, the property
    does not affect the height of the line box.
 
   <div class=example>
@@ -4489,7 +4445,7 @@ <h2 id=rendering-considerations><span class=secno>7 </span>Resolving font
   font-family: BodyText;
   src: local("HiraMaruPro-W4");
   font-variant: proportional-width;
-  font-feature-settings: "ital=1"; /* Latin italics within CJK text feature */
+  font-feature-settings: ital; /* Latin italics within CJK text feature */
 }
 
 body { font-family: BodyText, serif; }
@@ -4518,7 +4474,7 @@ <h2 id=rendering-considerations><span class=secno>7 </span>Resolving font
    <p>Adding an additional style rule with the @font-face above:</p>
 
    <pre>body         { font-family: main, Helvetica; }
-span         { font-feature-settings: "dlig=1"; }
+span         { font-feature-settings: dlig; }
 span.special { font-variant-ligatures: no-additional-ligatures; }
 </pre>
 
@@ -4535,7 +4491,8 @@ <h2 id=rendering-considerations><span class=secno>7 </span>Resolving font
     the OpenType <code>dlig</code> feature, because the ‘<a
     href="#propdef-font-feature-settings"><code
     class=property>font-feature-settings</code></a>’ is resolved after
-    that, the "dlig=1" value reenables additional ligatures.</p>
+    that, the ‘<code class=property>dlig</code>’ value reenables
+    additional ligatures.</p>
   </div>
   <!-- simple example of using both font-variant subproperty and descriptor value -->
   <!-- example showing conflicting values and how they are resolved -->
@@ -5122,8 +5079,8 @@ <h2 class=no-num id=index>Index</h2>
     title=font-style><strong>4.4</strong></a>, <a href="#propdef-font-style"
     title=font-style><strong>3.4</strong></a>
 
-   <li>font-style-synthetic, <a href="#propdef-font-style-synthetic"
-    title=font-style-synthetic><strong>3.8</strong></a>
+   <li>font-synthesis, <a href="#propdef-font-synthesis"
+    title=font-synthesis><strong>3.8</strong></a>
 
    <li>font-variant, <a href="#descdef-font-variant"
     title=font-variant><strong>4.6</strong></a>, <a
@@ -5149,9 +5106,6 @@ <h2 class=no-num id=index>Index</h2>
     title=font-weight><strong>4.4</strong></a>, <a
     href="#propdef-font-weight" title=font-weight><strong>3.2</strong></a>
 
-   <li>font-weight-synthetic, <a href="#propdef-font-weight-synthetic"
-    title=font-weight-synthetic><strong>3.8</strong></a>
-
    <li>full-width, <a href="#full-width"
     title=full-width><strong>6.10</strong></a>
 
@@ -5430,12 +5384,11 @@ <h2 class=no-num id=property-index>Property index</h2>
      <td>visual
 
     <tr valign=baseline>
-     <td><a class=property
-      href="#propdef-font-style-synthetic">font-style-synthetic</a>
+     <td><a class=property href="#propdef-font-synthesis">font-synthesis</a>
 
-     <td>auto | none | inherit
+     <td>none | [ weight || style ]
 
-     <td>auto
+     <td>weight style
 
      <td>all elements
 
@@ -5577,22 +5530,6 @@ <h2 class=no-num id=property-index>Property index</h2>
 
      <td>visual
 
-    <tr valign=baseline>
-     <td><a class=property
-      href="#propdef-font-weight-synthetic">font-weight-synthetic</a>
-
-     <td>auto | none | inherit
-
-     <td>auto
-
-     <td>all elements
-
-     <td>yes
-
-     <td>N/A
-
-     <td>visual
-
     <tr valign=baseline>
      <td><a class=property
       href="#propdef-vertical-position">vertical-position</a>