[css2] http://wiki.csswg.org/spec/css2.1#issue-114

bert-github · bert-github · commit 38e5dcd9db71 · 2010-07-19T18:59:31.000Z
--HG--
extra : convert_revision : svn%3A73dc7c4b-06e6-40f3-b4f7-9ed1dbc14bfc/trunk%403000
diff --git a/css2/fonts.src b/css2/fonts.src
@@ -1,6 +1,6 @@
 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN">
 <html lang="en">
-<!-- $Id: fonts.src,v 2.98 2010-04-19 16:12:36 bbos Exp $ -->
+<!-- $Id: fonts.src,v 2.99 2010-07-19 18:59:31 bbos Exp $ -->
 <head>
 <title>Fonts</title>
 <meta name="editor" lang="tr" content="Tantek &Ccedil;elik">
@@ -45,7 +45,7 @@ presented to each of them).
 <ol>
 
 <li>The User Agent makes (or accesses) a database of relevant CSS&nbsp;2.1
-properties of all the fonts of which the UA is aware. 
+properties of all the fonts of which the UA is aware.
 If there are two fonts with exactly the same properties, the user
 agent selects one of them.
 </li>
@@ -94,7 +94,7 @@ Otherwise the values must be matched exactly or font-style will fail.
 font labeled as 'small-caps', (2) a font in which the small caps are
 synthesized, or (3) a font where all lowercase letters are replaced by
 upper case letters. A small-caps font may be synthesized by
-electronically scaling uppercase letters from a normal font. 
+electronically scaling uppercase letters from a normal font.
 'normal' matches a font's normal (non-small-caps) variant. A font cannot fail to have a normal variant. A font
  that is only available as small-caps shall be selectable as either a 'normal' face or a 'small-caps' face.
 </li>
@@ -105,7 +105,7 @@ never fail. (See 'font-weight' below.)
 UA-dependent margin of tolerance. (Typically, sizes for scalable fonts
 are rounded to the nearest whole pixel, while the tolerance for
 bitmapped fonts could be as large as 20%.) Further computations, e.g.,
-by 'em' values in other properties, are based on 
+by 'em' values in other properties, are based on
 the computed value of 'font-size'.
 </li>
 
@@ -166,23 +166,39 @@ as a last alternative.  Generic font family names are keywords and must NOT be q
 </dd>
 </dl>
 
-<p>If an unquoted font family name contains 
-parentheses, brackets, and/or braces, they must still be  
-escaped per CSS grammar rules.  Similarly, quotation marks (both single and double), semicolons, 
-exclamation marks, commas, and leading slashes within unquoted font family names must be escaped. 
-Font names containing any such characters or white space should be quoted:
-</p>
+<p>Font family names must either be given quoted as <a
+href="syndata.html#strings">strings,</a> or unquoted as a sequence of
+one or more <a
+href="syndata.html#value-def-identifier">identifiers.</a> This means
+most punctuation characters and digits at the start of each token must
+be escaped in unquoted font family names.
+
+<p>For example, the following declarations are invalid:
+
+<pre>
+font-family: Red/Black, sans-serif;
+font-family: "Lucida" Grande, sans-serif;
+font-family: Ahem!, sans-serif;
+font-family: test@foo, sans-serif;
+font-family: #POUND, sans-serif;
+font-family: Hawaii 5-0, sans-serif;
+</pre>
+
+<p>If a sequence of identifiers is given as a font family name, the
+computed value is the name converted to a string by joining all the
+identifiers in the sequence by single spaces.
+
+<p>To avoid mistakes in escaping, it is recommended to quote font
+family names that contain white space, digits, or punctuation
+characters other than hyphens:
 
 <pre>
 body { font-family: "New Century Schoolbook", serif }
-  
-&lt;BODY STYLE="font-family: 'My own font', fantasy"&gt;
+
+&lt;BODY STYLE="font-family: '21st Century', fantasy">
 </pre>
 
-<p>If quoting is omitted, any white space characters before and after
-the font name are ignored and any sequence of white space characters
-inside the font name is converted to a single space.
-Font family <em>names</em> that happen to be the same as a keyword
+<p>Font family <em>names</em> that happen to be the same as a keyword
 value ('inherit', 'serif', 'sans-serif', 'monospace', 'fantasy', and
 'cursive') must be quoted to prevent confusion with the keywords with
 the same names. The keywords 'initial' and 'default' are reserved for
@@ -389,7 +405,7 @@ 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 
+with any emphasized words in oblique, and any emphasized words within
 an 'H3' oblique small-caps:
 </p>
 <pre>
@@ -434,7 +450,7 @@ strong { font-weight: bolder }
 values are names that are descriptive of the "weight" of a font. There
 is no accepted, universal meaning to these weight names. Their primary
 role is to distinguish faces of differing darkness within a single
-font family. Usage across font families is quite variant; for example, 
+font family. Usage across font families is quite variant; for example,
 a font that one might think of as being bold might be described as
 being <em>Regular, Roman, Book, Medium, Semi-</em> or <em>DemiBold,
 Bold,</em> or <em>Black,</em> depending on how black the "normal" face
@@ -577,8 +593,8 @@ have the following meanings:</p>
 <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>
-<p>The following table provides user agent guidelines for the absolute-size 
- mapping to HTML heading and absolute font-sizes. The 'medium' value is 
+<p>The following table provides user agent guidelines for the absolute-size
+ mapping to HTML heading and absolute font-sizes. The 'medium' value is
  the user's preferred font size and is used as the reference middle value.</p>
 
 <table border="1" style="border-collapse: collapse" width="73%" id="AutoNumber2">
@@ -616,10 +632,10 @@ computing the table. The table may be different from one font family
 to another.
 </p>
 
-<p class="note"><em><strong>Note 1.</strong> To preserve readability, a UA applying 
+<p class="note"><em><strong>Note 1.</strong> To preserve readability, a UA applying
 these guidelines should nevertheless avoid creating font-size resulting
  in less than 9 pixels per EM unit on a computer display.</em></p>
- 
+
 <p class="note"><em><strong>Note 2.</strong> In CSS1, the suggested
 scaling factor between adjacent indexes was 1.5, which user experience
 proved to be too large. In CSS2, the suggested scaling factor for a
@@ -688,10 +704,10 @@ 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. 
+<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>
@@ -737,7 +753,7 @@ fonts">system fonts</span>:</p>
 </dl>
 
 <p>System fonts may only be set as a whole; that is, the font
-family, size, weight, style, etc. are all set at the same time. 
+family, size, weight, style, etc. are all set at the same time.
 These values may then be altered individually if desired.  If no
 font with the indicated characteristics exists on a given platform,
 the user agent should either intelligently substitute (e.g., a smaller
@@ -781,7 +797,7 @@ button p {
   font-weight: 600;
   font-size: 9px;
   line-height: normal;
-} 
+}
 </pre>
 
 </div>
