[css-fonts] more editorial revisions

Author: John Daggett

css-fonts/Fonts.html

@@ -2066,18 +2066,19 @@ <h3 id=font-face-rule><span class=secno>4.1 </span>The
    <code>@font-face</code> rule</h3>
 
   <p>The <code>@font-face</code> rule allows for linking to fonts that are
-   automatically activated when needed. This allows authors to select a font
-   that closely matches the design goals for a given page rather than
-   limiting the font choice to a set of fonts available on all platforms. A
-   set of font descriptors define the location of a font resource, either
-   locally or externally, along with the style characteristics of an
-   individual face. Multiple <code>@font-face</code> rules can be used to
-   construct font families with a variety of faces. Using CSS font matching
-   rules, a user agent can selectively download only those faces that are
-   needed for a given piece of text.
-
-  <p>In terms of the grammar, this specification defines the following
-   productions:
+   automatically fetched and activated when needed. This allows authors to
+   select a font that closely matches the design goals for a given page
+   rather than limiting the font choice to a set of fonts available on all
+   platforms. A set of font descriptors define the location of a font
+   resource, either locally or externally, along with the style
+   characteristics of an individual face. Multiple <code>@font-face</code>
+   rules can be used to construct font families with a variety of faces.
+   Using CSS font matching rules, a user agent can selectively download only
+   those faces that are needed for a given piece of text.
+
+  <p>The @font-face rule consists of the @font-face at-keyword followed by a
+   block of descriptor declarations. In terms of the grammar, this
+   specification defines the following productions:
 
   <pre><dfn id=fontfacerule>font_face_rule</dfn>
   : FONT_FACE_SYM S* '{' S* descriptor_declaration? [ ';' S* descriptor_declaration? ]* '}' S*
@@ -2105,8 +2106,9 @@ <h3 id=font-face-rule><span class=secno>4.1 </span>The
    and do not apply to document language elements. There is no notion of
    which elements the descriptors apply to or whether the values are
    inherited by child elements. When a given descriptor occurs multiple times
-   in a given <code>@font-face</code> rule, only the last specified value is
-   used, all prior values for that descriptor are ignored.
+   in a given <code>@font-face</code> rule, only the last descriptor
+   declaration is used and all prior declarations for that descriptor are
+   ignored.
 
   <div class=example>
    <p>To use a downloadable font called Gentium:</p>
@@ -2126,30 +2128,27 @@ <h3 id=font-face-rule><span class=secno>4.1 </span>The
   </div>
 
   <p>A given set of <code>@font-face</code> rules define a set of fonts
-   available to containing documents. Multiple rules can be used to define a
-   family with a large set of faces. When font matching is done fonts defined
-   using these rules are considered before other available fonts on a system.
-   
+   available for use within the documents that contain these rules. When font
+   matching is done, fonts defined using these rules are considered before
+   other available fonts on a system.
 
-  <p>Downloaded fonts are only available to documents that reference them,
-   the process of activating these fonts should not make them available to
+  <p>Downloaded fonts are only available to documents that reference them.
+   The process of activating these fonts must not make them available to
    other applications or to documents that don't directly link to the same
    font. User agent implementers might consider it convenient to use
    downloaded fonts when rendering characters in other documents for which no
    other available font exists as part of the system font fallback procedure.
-   This would cause a security leak since the contents of one page would be
-   able to affect other pages, something an attacker could use as an attack
-   vector. These restrictions do not affect caching behavior, fonts are
-   cached the same way other web resources are cached.
-
-  <p>User agents which do not understand the <code>@font-face</code> rule
-   encounter the opening curly bracket and ignore forward until the closing
-   curly bracket. This at-rule conforms with the forward-compatible parsing
-   requirement of CSS, parsers may ignore these rules without error. Any
-   descriptors that are not recognized or implemented by a given user agent
-   must be ignored. <code>@font-face</code> rules require a font-family and
-   src descriptor, if either of these are missing the <code>@font-face</code>
-   must be ignored.
+   However, this would cause a security leak since the contents of one page
+   would be able to affect other pages, something an attacker could use as an
+   attack vector. These restrictions do not affect caching behavior, fonts
+   are cached the same way other web resources are cached.
+
+  <p>This at-rule follows the forward-compatible parsing rules of CSS. Like
+   properties in a declaration block, declarations of any descriptors that
+   are not supported by the user agent must be ignored.
+   <code>@font-face</code> rules require a font-family and src descriptor; if
+   either of these are missing, the <code>@font-face</code> rule is invalid
+   and must be ignored entirely.
 
   <p>In cases where user agents have limited platform resources or implement
    the ability to disable downloadable font resources,
@@ -2179,15 +2178,14 @@ <h3 id=font-family-desc><span class=secno>4.2 </span>Font family: the <a
   </table>
 
   <p>This descriptor defines the font family name that will be used in all
-   CSS font family name matching, overriding font family names contained in
-   the underlying font data. If the font family name is the same as a font
-   family available in a given user's environment, it effectively hides the
-   underlying font for documents that use the stylesheet. This permits a web
-   author to freely choose font-family names without worrying about conflicts
-   with font family names present in a given user's environment. Errors
-   loading font data do not affect font name matching behavior. User agents
-   that apply platform font aliasing rules to font family names defined via
-   <code>@font-face</code> rules are considered non-conformant.
+   CSS font family name matching. It is required for the @font-face rule to
+   be valid. It overrides the font family names contained in the underlying
+   font data. If the font family name is the same as a font family available
+   in a given user's environment, it effectively hides the underlying font
+   for documents that use the stylesheet. This permits a web author to freely
+   choose font-family names without worrying about conflicts with font family
+   names present in a given user's environment. Likewise, platform
+   substitutions for a given font family name must not be used.
 
   <h3 id=src-desc><span class=secno>4.3 </span>Font reference: the <a
    href="#descdef-src">src</a> descriptor</h3>
@@ -2202,7 +2200,7 @@ <h3 id=src-desc><span class=secno>4.3 </span>Font reference: the <a
     <tr>
      <td>Value:
 
-     <td>[ &lt;uri> [format(&lt;string>#)]? | &lt;font-face-name> ]#
+     <td>[ &lt;url> [format(&lt;string>#)]? | &lt;font-face-name> ]#
 
     <tr>
      <td><em>Initial:</em>
@@ -2211,15 +2209,14 @@ <h3 id=src-desc><span class=secno>4.3 </span>Font reference: the <a
   </table>
 
   <p>This descriptor specifies the resource containing font data. It is
-   required, whether the font is downloadable or locally installed. Its value
-   is a prioritized, comma-separated list of external references or locally
+   required for the <code>@font-face</code> rule to be valid. Its value is a
+   prioritized, comma-separated list of external references or locally
    installed font face names. When a font is needed the user agent iterates
    over the set of references listed, using the first one it can successfully
    activate. Fonts containing invalid data or local font faces that are not
-   found are ignored and the user agent loads the next font in the list
-   (platform substitutions for a given font must not be used).
+   found are ignored and the user agent loads the next font in the list.
 
-  <p>As with other URIs in CSS, the URI may be partial, in which case it is
+  <p>As with other URLs in CSS, the URL may be partial, in which case it is
    resolved relative to the location of the style sheet containing the <span
    class=index-inst id=font-face0
    title="@font-face"><code>@font-face</code></span> rule. In the case of SVG
@@ -2239,8 +2236,8 @@ <h3 id=src-desc><span class=secno>4.3 </span>Font reference: the <a
 src: url(fonts.svg#simple);   /* load SVG font with id 'simple' */
 </pre>
 
-  <p>External references consist of a URI, followed by an optional hint
-   describing the format of the font resource referenced by that URI. The
+  <p>External references consist of a URL, followed by an optional hint
+   describing the format of the font resource referenced by that URL. The
    format hint contains a comma-separated list of format strings that denote
    well-known font formats. Conformant user agents must skip downloading a
    font resource if the format hints indicate only unsupported or unknown
@@ -2316,13 +2313,13 @@ <h3 id=src-desc><span class=secno>4.3 </span>Font reference: the <a
    this).
 
   <p>When authors would prefer to use a locally available copy of a given
-   font and download it if it's not, local() can be used. The locally
-   installed <span class=index-def id=ltfont-face-namegt
+   font and download it if it's not, <code>local()</code> can be used. The
+   locally-installed <span class=index-def id=ltfont-face-namegt
    title="&lt;font-face-name&gt;"><a
-   name=value-def-font-face-name>&lt;font-face-name&gt;</a></span> is a
-   format-specific string that uniquely identifies a single font face within
-   a larger family. The syntax for a &lt;font-face-name&gt; is a unique font
-   face name enclosed by "local(" and ")".
+   name=value-def-font-face-name>&lt;font-face-name&gt;</a></span> argument
+   is a format-specific string that uniquely identifies a single font face
+   within a larger family. The syntax for a &lt;font-face-name&gt; is a
+   unique font face name enclosed by "local(" and ")".
 
   <pre>
 /* regular face of Gentium */
@@ -2337,7 +2334,8 @@ <h3 id=src-desc><span class=secno>4.3 </span>Font reference: the <a
    fonts, this string is used to match only the Postscript name or the full
    font name in the name table of locally available fonts. Which is used
    varies by platform and font, so authors should include both of these names
-   to assure proper matching across platforms.
+   to assure proper matching across platforms. Platform substitutions for a
+   given font name must not be used.
 
   <pre>
 /* bold face of Gentium */
@@ -2351,9 +2349,10 @@ <h3 id=src-desc><span class=secno>4.3 </span>Font reference: the <a
 </pre>
 
   <p>Just as a <code>@font-face</code> rule specifies the characteristics of
-   a single font within a family, the unique name used with local() specifies
-   a single font, not an entire font family. Defined in terms of OpenType
-   font data, the Postscript name is found in the font's <a
+   a single font within a family, the unique name used with
+   <code>local()</code> specifies a single font, not an entire font family.
+   Defined in terms of OpenType font data, the Postscript name is found in
+   the font's <a
    href="http://www.microsoft.com/typography/otspec/name.htm">name table</a>,
    in the name record with nameID = 6 (see <a href="#OPENTYPE"
    rel=biblioentry>[OPENTYPE]<!--{{!OPENTYPE}}--></a> for more details). The
@@ -2409,10 +2408,9 @@ <h3 id=src-desc><span class=secno>4.3 </span>Font reference: the <a
 }
 </pre>
 
-   <p>Since localized fullnames should never match, a document with the
-    header style rules below would always render using the default serif
-    font, regardless whether a particular system locale parameter is set to
-    Finnish or not:</p>
+   <p>Since localized fullnames never match, a document with the header style
+    rules below would always render using the default serif font, regardless
+    whether a particular system locale parameter is set to Finnish or not:</p>
 
    <pre>
 @font-face {
@@ -2424,7 +2422,7 @@ <h3 id=src-desc><span class=secno>4.3 </span>Font reference: the <a
 h2 { font-family: SectionHeader, serif; }
 </pre>
 
-   <p>A conformant user agent should never load the font ‘<code
+   <p>A conformant user agent would never load the font ‘<code
     class=css>gentium.eot</code>’ in the example below, since it is
     included in the first definition of the ‘<a href="#descdef-src"><code
     class=property>src</code></a>’ descriptor which is overridden by the
@@ -5183,9 +5181,9 @@ <h3 id=feature-precedence-examples><span class=secno>7.3 </span>Feature
 
   <div class=example>
    <p>The <code>@font-face</code> rule can also be used to access font
-    features in locally available fonts via the use of local() in the ‘<a
-    href="#descdef-src"><code class=property>src</code></a>’ descriptor of
-    the <code>@font-face</code> definition:</p>
+    features in locally available fonts via the use of <code>local()</code>
+    in the ‘<a href="#descdef-src"><code class=property>src</code></a>’
+    descriptor of the <code>@font-face</code> definition:</p>
 
    <pre>@font-face {
   font-family: BodyText;
@@ -6535,7 +6533,7 @@ <h2 class=no-num id=property-index>Property index</h2>
     <tr>
      <th><a class=property href="#descdef-src">src</a>
 
-     <td>[ &lt;uri> [format(&lt;string>#)]? | &lt;font-face-name> ]#
+     <td>[ &lt;url> [format(&lt;string>#)]? | &lt;font-face-name> ]#
 
      <td>N/A