[css2] Tantek's proposed additional text.

bert-github · bert-github · commit d877d0b835e6 · 2003-01-13T12:30:31.000Z
--HG--
extra : convert_revision : svn%3A73dc7c4b-06e6-40f3-b4f7-9ed1dbc14bfc/trunk%402006
diff --git a/css2/fonts.src b/css2/fonts.src
@@ -1,7 +1,7 @@
 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"
         "http://www.w3.org/TR/1998/REC-html40-19980424/loose.dtd">
 <html lang="en">
-<!-- $Id: fonts.src,v 2.70 2002-12-17 19:12:27 bbos Exp $ -->
+<!-- $Id: fonts.src,v 2.71 2003-01-13 12:30:31 bbos Exp $ -->
 <head>
 <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
 <title>Fonts</title>
@@ -165,8 +165,18 @@ as a last alternative.  Generic font family names are keywords and must NOT be q
 </dd>
 </dl>
 
+<ins class="proposed">
+<p>If an unquoted font family name contains 
+parentheses, brackets, and/or braces, they must still be either balanced or 
+escaped per CSS grammar rules.  Similarly, quote marks, semicolons, 
+exclamation marks and commas within unquoted font family names must be escaped. 
+Font names containing any such characters or whitespace should be quoted:
+</p>
+</ins>
+<del class="proposed">
 <p>Font names containing whitespace should be quoted:
 </p>
+</del>
 <pre>
 body { font-family: "New Century Schoolbook", serif }
   
@@ -193,20 +203,20 @@ labeled 'oblique'. A value of 'italic' selects a font that is labeled
 </p>
 <p>The font that is labeled 'oblique' in the UA's font database may
 actually have been generated by electronically slanting a normal font.
-
+</p>
 <p>Fonts with Oblique, Slanted or Incline in their names will
 typically be labeled 'oblique' in the UA's font database. Fonts with
 <em>Italic, Cursive</em> or <em>Kursiv</em> in their names will
 typically be labeled 'italic'.
-
+</p>
 <pre>
 h1, h2, h3 { font-style: italic }
 h1 em { font-style: normal }
 </pre>
 
 <p>In the example above, emphasized text within 'H1' will appear in a
 normal face.
-
+</p>
 <h2><a name="small-caps">Small-caps</a>: the
 <span class="propinst-font-variant">'font-variant'</span> property</h2>
 
@@ -216,18 +226,18 @@ normal face.
 In a small-caps font the lower case letters look similar to the
 uppercase ones, but in a smaller size and with slightly different
 proportions. The 'font-variant' property selects that font.
-
+</p>
 <p>A value of 'normal' selects a font that is not a small-caps font,
 'small-caps' selects a small-caps font. It is acceptable (but not
 required) in CSS&nbsp;2.1 if the small-caps font is a created by taking a
 normal font and replacing the lower case letters by scaled uppercase
 characters. As a last resort, uppercase letters will be used as
 replacement for a small-caps font.
-
+</p>
 <p>The following example results in an 'H3' element in small-caps,
 with any emphasized words in oblique, and any emphasized words within 
 an 'H3' oblique small-caps:
-
+</p>
 <pre>
 h3 { font-variant: small-caps }
 em { font-style: oblique }
@@ -236,11 +246,11 @@ em { font-style: oblique }
 <p>There may be other variants in the font family as well, such as
 fonts with old-style numerals, small-caps numerals, condensed or
 expanded letters, etc. CSS&nbsp;2.1 has no properties that select those.
-
+</p>
 <p><em>Note:</em> insofar as this property causes text to be
 transformed to uppercase, the same considerations as for <a
 href="#text-transform">'text-transform'</a> apply.
-
+</p>
 <h2><a name="font-boldness">Font boldness</a>: the
 <span class="propinst-font-weight">'font-weight'</span> property</h2>
 
@@ -253,21 +263,21 @@ keyword 'normal' is synonymous with '400', and 'bold' is synonymous
 with '700'. Keywords other than 'normal' and 'bold' have been shown to
 be often confused with font names and a numerical scale was therefore
 chosen for the 9-value list.
-
+</p>
 <pre>
 p { font-weight: normal }   /* 400 */
 h1 { font-weight: 700 }     /* bold */
 </pre>
 
 <p>The 'bolder' and 'lighter' values select font weights that are
 relative to the weight inherited from the parent:
-
+</p>
 <pre>
 strong { font-weight: bolder }
 </pre>
 
 <p>Child elements inherit the resultant weight, not the keyword value.
-
+</p>
 <p>Fonts (the font data) typically have one or more properties whose
 values are names that are descriptive of the "weight" of a font. There
 is no accepted, universal meaning to these weight names. Their primary
@@ -282,24 +292,23 @@ scale in which the value '400' (or 'normal') corresponds to the
 "normal" text face for that family. The weight name associated with
 that face will typically be <em>Book, Regular, Roman, Normal</em> or
 sometimes <em>Medium</em>.
-
+</p>
 <p>The association of other weights within a family to the numerical
 weight values is intended only to preserve the ordering of darkness
 within that family. However, the following heuristics tell how the
 assignment is done in typical cases:
-
+</p>
 <ul>
-
 <li>If the font family already uses a numerical scale with nine values
 (like e.g. <em>OpenType</em> does), the font weights should be mapped
 directly.
-
+</li>
 <li>If there is both a face labeled <em>Medium</em> and one labeled
 <em>Book, Regular, Roman</em> or <em>Normal,</em> then the
 <em>Medium</em> is normally assigned to the '500'.
-
+</li>
 <li>The font labeled "Bold" will often correspond to the weight value '700'.
-
+</li>
 <li>If there are fewer then 9 weights in the family, the default
 algorithm for filling the "holes" is as follows. If '500' is
 unassigned, it will be assigned the same font as '400'. If any of the
@@ -308,7 +317,7 @@ assigned to the same face as the next darker assigned keyword, if any,
 or the next lighter one otherwise. If any of '300', '200' or '100'
 remains unassigned, it is assigned to the next lighter assigned
 keyword, if any, or the next darker otherwise.
-
+</li>
 </ul>
 
 <p>The following two examples show typical mappings.</p>
@@ -320,12 +329,12 @@ darkest: <em>Regular, Medium, Bold, Heavy.</em></p>
 <caption>First example of font-weight mapping</caption>
 <!-- rattlesnake, ostrich and more at the Austin meeting -->
 <thead>
-<tr><th>Available faces <th>Assignments <th>Filling the holes
+<tr><th>Available faces </th><th>Assignments </th><th>Filling the holes</th></tr>
 </thead>
-<tr><td>"Rattlesnake Regular"    <td> 400          <td> 100, 200, 300
-<tr><td>"Rattlesnake Medium"     <td> 500          <td>&nbsp;
-<tr><td>"Rattlesnake Bold"       <td> 700          <td> 600
-<tr><td>"Rattlesnake Heavy"      <td> 800          <td> 900
+<tr><td>"Rattlesnake Regular"</td><td> 400     </td><td> 100, 200, 300</td></tr>
+<tr><td>"Rattlesnake Medium" </td><td> 500     </td><td>&nbsp;</td></tr>
+<tr><td>"Rattlesnake Bold"   </td><td> 700     </td><td> 600</td></tr>
+<tr><td>"Rattlesnake Heavy"  </td><td> 800     </td><td> 900</td></tr>
 </table>
 </div>
 
@@ -340,14 +349,14 @@ value to "Ice Prawn ExtraBlack".</p>
                 that ExtraBlack is not mapped to a value.">
 <caption>Second example of font-weight mapping</caption>
 <thead>
-<tr><th>Available faces <th>Assignments <th>Filling the holes
+<tr><th>Available faces </th><th>Assignments </th><th>Filling the holes</th></tr>
 </thead>
-<tr><td>"Ice Prawn Book"       <td> 400          <td> 100, 200, 300
-<tr><td>"Ice Prawn Medium"     <td> 500          <td>&nbsp;
-<tr><td>"Ice Prawn Bold"       <td> 700          <td> 600
-<tr><td>"Ice Prawn Heavy"      <td> 800          <td>&nbsp;
-<tr><td>"Ice Prawn Black"      <td> 900          <td>&nbsp;
-<tr><td>"Ice Prawn ExtraBlack" <td> (none)       <td>&nbsp;
+<tr><td>"Ice Prawn Book"  </td><td> 400     </td><td> 100, 200, 300</td></tr>
+<tr><td>"Ice Prawn Medium"</td><td> 500     </td><td>&nbsp;</td></tr>
+<tr><td>"Ice Prawn Bold"  </td><td> 700     </td><td> 600</td></tr>
+<tr><td>"Ice Prawn Heavy" </td><td> 800     </td><td>&nbsp;</td></tr>
+<tr><td>"Ice Prawn Black" </td><td> 900     </td><td>&nbsp;</td></tr>
+<tr><td>"Ice Prawn ExtraBlack"</td><td> (none)  </td><td>&nbsp;</td></tr>
 </table>
 </div>
 
@@ -359,20 +368,19 @@ the matching of 'bolder' is to the next darker face available on the
 client within the family and the matching of 'lighter' is to the next
 lighter face within the family. To be precise, the meaning of the
 relative keywords 'bolder' and 'lighter' is as follows:
-
+</p>
 <ul>
-
 <li>'bolder' selects the next weight that is assigned to a font that
 is darker than the inherited one. If there is no such weight, it
 simply results in the next darker numerical value (and the font
 remains unchanged), unless the inherited value was '900' in which case
 the resulting weight is also '900'.
-
+</li>
 <li>'lighter' is similar, but works in the opposite direction: it
 selects the next lighter keyword with a different font from the
 inherited one, unless there is no such font, in which case it selects
 the next lighter numerical value (and keeps the font unchanged).
-
+</li>
 </ul>
 
 <p>There is no guarantee that there will be a darker face for each of
@@ -381,7 +389,7 @@ normal and a bold face, while others may have eight face weights.
 There is no guarantee on how a UA will map font faces within a family
 to weight values. The only guarantee is that a face of a given value
 will be no less dark than the faces of lighter values.
-
+</p>
 <h2><a name="font-size-props">Font size</a>: the <span
 class="propinst-font-size">'font-size'</span>
 property</h2>
@@ -394,10 +402,10 @@ have the following meanings:</p>
 
 <dl>
 <dt><b><a name="value-def-absolute-size">&lt;absolute-size&gt;</a></b>
-
+</dt>
 <dd>An &lt;absolute-size&gt; keyword is an index to a table of font
 sizes computed and kept by the UA. Possible values are:
-<p> [ xx-small | x-small | small | medium | large | x-large | xx-large ]
+<p> [ xx-small | x-small | small | medium | large | x-large | xx-large ]</p>
 <p>The following table provides user agent guidelines for the absolute-size 
 scaling factor and their mapping to HTML heading and absolute font-sizes. The 
 'medium' value is used as the reference middle value. The user agent may fine 
@@ -468,9 +476,9 @@ screen between adjacent indexes was 1.2 which still created issues for the small
 sizes. The new scaling factor varies between each index to provide better 
 readability.</em></p>
 
-
+</dd>
 <dt><b><a name="value-def-relative-size">&lt;relative-size&gt;</a></b>
-
+</dt>
 <dd>A &lt;relative-size&gt; keyword is interpreted relative to the
 table of font sizes and the font size of the parent element. Possible
 values are: [ larger | smaller ]. For example, if the parent element
@@ -480,24 +488,24 @@ is not close to a table entry, the UA is free to interpolate between
 table entries or round off to the closest one. The UA may have to
 extrapolate table values if the numerical value goes beyond the
 keywords.
-
+</dd>
 </dl>
 
 <p>Length and percentage values should not take the font size table
 into account when calculating the font size of the element.
-
+</p>
 <p>Negative values are not allowed.
-
+</p>
 <p>On all other properties, 'em' and 'ex' length values refer to the
 computed font size of the current element. On the 'font-size' property, these
 length units refer to the computed font size of the parent element.
-
+</p>
 <p>Note that an application may reinterpret an explicit size,
 depending on the context. E.g., inside a VR scene a font may get a
 different size because of perspective distortion.
-
+</p>
 <p>Examples:
-
+</p>
 <pre>
 p { font-size: 16px; }
 @media print {
@@ -525,13 +533,13 @@ setting
 sheet. The syntax of this property is based on a traditional
 typographical shorthand notation to set multiple properties related to
 fonts.
-
+</p>
 <p>All font-related properties are first reset to their initial values, 
 including those listed in the preceding paragraph. 
 Then, those properties that are given explicit values in the 
 <span class="propinst-font">'font'</span> shorthand are set to those values. 
 For a definition of allowed and initial values, see the previously defined properties.
-
+</p>
 <pre>
 p { font: 12px/14px sans-serif }
 p { font: 80% sans-serif }
@@ -543,35 +551,35 @@ p { font: normal small-caps 120%/120% fantasy }
 <p>In the second rule, the font size percentage value ('80%') refers
 to the font size of the parent element. In the third rule, the line
 height percentage refers to the font size of the element itself.
-
+</p>
 <p>In the first three rules above, the 'font-style', 'font-variant'
 and 'font-weight' are not explicitly mentioned, which means they are
 all three set to their initial value ('normal'). The fourth rule sets
 the 'font-weight' to 'bold', the 'font-style' to 'italic' and
 implicitly sets 'font-variant' to 'normal'.
-
+</p>
 <p>The fifth rule sets the 'font-variant' ('small-caps'), the
 'font-size' (120% of the parent's font), the 'line-height' (120% times
 the font size) and the 'font-family' ('fantasy'). It follows that the
 keyword 'normal' applies to the two remaining properties: 'font-style'
 and 'font-weight'.
-
+</p>
 <p>The following values refer to <span class="index-def" title="system
 fonts">system fonts</span>:</p>
 
 <dl>
-<dt>caption
-<dd>The font used for captioned controls (e.g., buttons, drop-downs, etc.).
-<dt>icon
-<dd>The font used to label icons.
-<dt>menu
-<dd>The font used in menus (e.g., dropdown menus and menu lists).
-<dt>message-box
-<dd>The font used in dialog boxes.
-<dt>small-caption
-<dd>The font used for labeling small controls.
-<dt>status-bar
-<dd>The font used in window status bars.
+<dt>caption</dt>
+<dd>The font used for captioned controls (e.g., buttons, drop-downs, etc.).</dd>
+<dt>icon</dt>
+<dd>The font used to label icons.</dd>
+<dt>menu</dt>
+<dd>The font used in menus (e.g., dropdown menus and menu lists).</dd>
+<dt>message-box</dt>
+<dd>The font used in dialog boxes.</dd>
+<dt>small-caption</dt>
+<dd>The font used for labeling small controls.</dd>
+<dt>status-bar</dt>
+<dd>The font used in window status bars.</dd>
 </dl>
 
 <p>System fonts may only be set as a whole; that is, the font
@@ -584,15 +592,14 @@ font), or substitute a user agent default font. As for regular fonts,
 if, for a system font, any of the individual properties are not part
 of the operating system's available user preferences, those properties
 should be set to their initial values.
-
+</p>
 <p id="almost">That is why this property is "almost" a shorthand property: system
 fonts can only be specified with this property, not with <span
 class="propinst-font-family">'font-family'</span> itself, so <span
 class="propinst-font">'font'</span> allows authors to do more than the
 sum of its subproperties. However, the individual properties such as <span class="propinst-font-weight">'font-weight'</span> are still given values taken from the system font, which can be independently varied.</p>
 
-<div class="example"><p>
-
+<div class="example">
 <pre>
 button { font: 300 italic 1.3em/1.7em "FB Armada", sans-serif }
 button p { font: menu }
@@ -603,15 +610,15 @@ button p em { font-weight: bolder }
 happened to be, for example, 9-point Charcoal, with a weight of 600, then P
 elements that were descendants of BUTTON would be displayed as if
 this rule were in effect:
-
+</p>
 <pre>
 button p { font: 600 9px Charcoal }
 </pre>
 
 <p>Because the <span class="propinst-font">'font'</span> shorthand
 property resets any property not explicitly given a value
 to its initial value, this has the same effect as this declaration:
-
+</p>
 <pre>
 button p {
   font-family: Charcoal;
