[css2] made changes requested by Ian

svgeesus · svgeesus · commit 40abda27f9f4 · 1998-04-30T23:44:17.000Z
--HG--
extra : convert_revision : svn%3A73dc7c4b-06e6-40f3-b4f7-9ed1dbc14bfc/trunk%401606
diff --git a/css2/fonts.src b/css2/fonts.src
@@ -1,6 +1,6 @@
 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
 <html lang="en">
-<!-- $Id: fonts.src,v 2.44 1998-04-30 21:44:12 howcome Exp $ -->
+<!-- $Id: fonts.src,v 2.45 1998-04-30 23:43:42 clilley Exp $ -->
 <HEAD>
 <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
 <TITLE>Fonts</TITLE>
@@ -62,8 +62,7 @@ is not immediately available.
 
 <p>CSS2 improves client-side font matching, enables font
 synthesis and progressive rendering, and enables fonts to be
-downloaded over the Web.
-
+downloaded over the Web. These enhanced capabilities are referred to as 'WebFonts'
 
 <P>In the CSS2 font model, as in CSS1, each user agent has a "font
 database" at its disposition. CSS1 referred to this database but gave no details about what was in it. CSS2 defines the information in that database and allows style sheet authors to contribute to it. When asked to display a character with a particular font,
@@ -232,8 +231,6 @@ href="syndata.html#ignore">ignored</a></span> and any sequence of
 whitespace characters inside the font name is converted to a single
 space.
 
-<!-- Change should to must above? -IJ -->
-
     <DT><span class="index-def"
 title="&lt;generic-family&gt;::definition of"><a name="value-def-generic-family" class="value-def"><strong>&lt;generic-family&gt;</strong></a></span>
     <DD>
@@ -242,7 +239,7 @@ title="&lt;generic-family&gt;::definition of"><a name="value-def-generic-family"
       'fantasy', and 'monospace'. Please see the section on
       <a href="#generic-font-families">generic font families</a> for
       descriptions of these families. Generic font family names
-      are keywords and therefore must not be quoted.
+      are keywords, and therefore must not be quoted.
 
 <P>Authors are encouraged to offer a generic font family as a
       last alternative, for improved robustness.</p>
@@ -274,7 +271,6 @@ For example:
 *:lang(ja-jp) { font: 900 14pt/16pt "Heisei Mincho W9", serif }
 *:lang(zh-tw) { font: 800 14pt/16.5pt "Li Sung", serif }
 </pre>
-<!-- need to check tw for traditional chinese as used in taiwan -->
 
 <p>This selects any element that has the given language - Japanese or Traditional Chinese - and requests the appropriate font.
 </div>
@@ -329,7 +325,7 @@ H1 EM { font-style: normal }
 to the uppercase ones, but in a smaller size and with slightly
 different proportions. The <span
 class="propinst-font-variant">'font-variant'</span> property requests such a font for <span class="index-def" title="bicameral::definition of">bicameral</span> (having two cases, as with Latin script). This property has no visible effect for scripts that are
-<span class="index-def" title="unicameral, definition of"><dfn>unicameral</dfn></span> (having only one case, as with most of the world's writing systems). Values have the following
+<span class="index-def" title="unicameral::definition of"><dfn>unicameral</dfn></span> (having only one case, as with most of the world's writing systems). Values have the following
 meanings:</p>
 
 <dl>
@@ -511,8 +507,6 @@ due a numerical value on 'font-size-adjust' and the unavailability
   class="propinst-font-size-adjust">'font-size-adjust'</span> would
   compound).
 
- <!-- hakons suggested full fix of this involves changes that alter semantics from CSS1, so I didn't do that yet -CL -->
-
 <div class="example"><P>
 
 <PRE>
@@ -672,7 +666,7 @@ class="propinst-font">'font'</span> shorthand property.
 fonts">system fonts</span>:</p>
 
 <dl>
-<dt><strong>caption</strong><!-- strong?? you mean like, bold? -->
+<dt><strong>caption</strong><!-- strong?? you mean like, shouted? ;-) -->
 <dd>The font used for captioned controls (e.g., buttons, drop-downs, etc.).
 <dt><strong>icon</strong>
 <dd>The font used to label icons.
@@ -701,7 +695,6 @@ 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>
-<!-- strange glitch, the last two paragraphs occurred twice in slightly different forms - merged and the spare copy deleted -CL -->
 
 <div class="example"><p>
 
@@ -712,12 +705,15 @@ BUTTON P EM { font-weight: bolder }
 </pre>
 
 <p>If the font used for dropdown menus on a particular system
-happened to be 9-point Charcoal, with a weight of 600, then P
+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 (the values for the remaining properties
-being taken from the initial values):
+this rule were in effect:
 
-<!-- Not clear to me -IJ -->
+<pre>
+BUTTON P { font: 9pt 600 Charcoal }
+</pre>
+
+<p>Because the <span class="propinst-font">'font'</span> shorthand resets to its initial value any property not explicitly given a value, this has the same effect as this declaration:
 
 <pre>
 BUTTON P {
@@ -938,8 +934,6 @@ read while the requested font downloads. Once the real font has been
 successfully downloaded, it replaces the
 temporary font, hopefully without the need to reflow.
 
-<!-- near duplicate paragraph removed -->
-
 <div class="note"><P>
 <em><strong>Note.</strong>
 Progressive rendering requires metric information about the font in
@@ -1086,7 +1080,7 @@ stylesheet -->
 wins and the rest must be ignored.
 
 <p>Also, any descriptors that are not recognized or useful to the
-user agent should be <span class="index-inst" title="ignore"><a
+user agent must be <span class="index-inst" title="ignore"><a
 href="syndata.html#ignore">ignored</a></span>. Future versions of CSS
 may allow additional descriptors for the purpose of better font
 substitution, matching, or synthesis.</p>
@@ -1293,8 +1287,6 @@ other descriptors depend on it.
 
 <!-- #include src=descriptors/units-per-em.srb -->
 
-<!-- Is this the definition of em-width? -IJ -->
-<!-- No, it is the definition of how the em-width is subdivided to form a coordinate system for describing the shape of each glyph -CL -->
 
 <p>This is the descriptor for the number of the <a
 href="#emsq">coordinate units on the em square</a>, the
@@ -1308,10 +1300,9 @@ downloadable or locally installed.
 
 <!-- #include src=descriptors/src.srb -->
 
-<p>This is a <!-- where is the font characteristic, -CL --> prioritized, comma-separated list of external references and/or locally
+<p>This is a  prioritized, comma-separated list of external references and/or locally
 installed font face names. The external reference points to the font data on the Web. This is required if the WebFont is to be downloaded. The font resource
 may be a subset of the source font, for example it may contain only the glyphs needed for the current page or for a set of pages.
-<!-- move some of this discussion to characteristics section? -CL -->
 
 <p>The external reference consists of a URI, followed by an optional hint regarding the format of font resource to be found at that URI, and this information should be used by clients to avoid following links to fonts in formats they are unable to use. As with any hypertext reference, there may be other formats available, but the client has a better idea of what is likely to be there, in a more robust way than trying to parse filename extensions in URIs.
 
@@ -1334,7 +1325,7 @@ that denote well-known font formats. The user agent will recognize the name of f
 
 <p>As with <a href="syndata.html#uri">other URIs in CSS</a>, the URI may be partial, in which case it is resolved relative to the location of the style sheet containing the <span class="index-inst" title="@font-face"> @font-face</span>.
 
-<p> The <span class="index-def" title="&lt;font-face-name&gt;::definition
+<p> The locally-installed <span class="index-def" title="&lt;font-face-name&gt;::definition
 of"><a name="value-def-font-face-name">&lt;font-face-name&gt;</a></span>
 is the full font name of a locally installed font. The <span
 class="index-def" title="full font name"><dfn>full font
@@ -1391,18 +1382,20 @@ class="descinst-panose-1">'panose-1'</span>,
 </h3>
 
 <P>These descriptors are optional for a CSS2 definition,
-but may be used if intelligent font matching or font size adjustment is desired by the author.
+but may be used if intelligent font matching or font size adjustment 
+is desired by the author.
 
 <!-- #include src=descriptors/panose-1.srb -->
 
 <p>This is the descriptor for the <a href="#pan1">Panose-1 number</a>
-and consists of ten decimal numbers, separated by <a
+and consists of ten decimal integers, separated by <a
 href="syndata.html#whitespace">whitespace</a>. A comma-separated list
 is not permitted for this descriptor, because the <span
 class="index-inst" title="panose-1">Panose-1</span> system can
 indicate that a range of values are matched. The initial value is zero,
 which means "any", for each PANOSE digit; all fonts will match the
-Panose number if this value is used. Use of the Panose-1 descriptor is strongly recommended for latin fonts.
+Panose number if this value is used. Use of the Panose-1 descriptor 
+is strongly recommended for latin fonts. For further details, see <a href="notes.html#panose">Appendix C</a>.
 
 
 <!-- #include src=descriptors/stemv.srb -->
@@ -1598,6 +1591,8 @@ value such as the ascent. If this descriptor is used, the
   <tr><td>Swiss 721 Expanded   <td>roman, bold, italic, bold italic
 </table>
 
+<p>The following font descriptions could be used to make them available for download.
+
 <pre>
 @font-face {
     font-family: "Swiss 721";
@@ -1922,31 +1917,8 @@ Chinese/Japanese/Korean).
 
 <!-- [start non-normative block, HWL]
 
- Panose-1 technology was originally
-developed by Elseware Corporation and is now owned by Hewlett Packard.
-
-
-<p><img src="./images/panose-16.gif" alt="Illustration of Panose-1"></p>
-
-<p>The Family, Serif Style and Proportion numbers are used by
-Windows95 for font selection and matching.
-
-<p>The meaning of the ten numbers and the allowable values (given in
-parentheses) are given in <a href="notes.html#panose">Appendix
-C</a> for the most common case, where the "family" digit is <tt>2,
-Text and Display</tt>. (If the first digit has a different value, the
-remaining nine digits have different meanings).
-
-<p><em>Panose-2</em> (see [[-PANOSE2]]) is a specification for a
-more comprehensive font classification and matching technology which
-is not limited to Latin typefaces. For example, the serif
-characteristics of a Latin face may be compared with the stroke
-terminations of a Kanji face.
 
-<p><img src="./images/P2F24.gif" alt="Illustration of Panose-2"></p>
 
-<p>The Panose-2 value is not stored inside any known font formats, but
-may be measured.
 
 [end non-normative block, HWL] -->
 
diff --git a/css2/notes.src b/css2/notes.src
@@ -1,6 +1,6 @@
 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
 <html lang="en">
-<!-- $Id: notes.src,v 2.11 1998-04-30 19:23:59 howcome Exp $ -->
+<!-- $Id: notes.src,v 2.12 1998-04-30 23:44:17 clilley Exp $ -->
 <HEAD>
 <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
 <TITLE>Appendix C: Implementation and performance notes</TITLE>
@@ -216,14 +216,22 @@ assertion into the font resource.
 platforms. To select a preferred font format, transparent content
 negotiation is used (see [[-NEGOT]]). It is always possible to
 tell when a font is being dereferenced, because the URI is inside a
-font description. Thus, only the relevant Accept headers need be sent
-(not headers related to images, HTML, etc).
+font description. A given implementation will know which downloadable 
+font formats it supports and can thus use the format hint to avoid 
+downloading fonts in an unsupported format.
 
 <h2><a name="panose">Meaning of the Panose Digits</a></h2>
 
-<p>If the "Family" digit has a value other than "2" (the most common
-case), the remaining nine digits have different meanings than those
-given here. For further details on Panose-1, see [[-PANOSE]].
+<p><img src="./images/panose-16.gif" alt="Illustration of Panose-1"></p>
+
+<p>The Family, Serif Style and Proportion numbers are used by
+Windows95 for font selection and matching.
+
+<p>The meaning of the ten numbers and the allowable values (given in
+parentheses) are given below  for the most common case, where the "family" 
+digit is <tt>2, Text and Display</tt>. (If the first digit has a different 
+value, the remaining nine digits have different meanings). For further 
+details on Panose-1, see [[-PANOSE]].
 
 <dl>
 <dt>Family
@@ -378,6 +386,16 @@ given here. For further details on Panose-1, see [[-PANOSE]].
 </ul>
 </dl>
 
+<p><em>Panose-2</em> (see [[-PANOSE2]]) is a specification for a
+more comprehensive font classification and matching technology which
+is not limited to Latin typefaces. For example, the serif
+characteristics of a Latin face may be compared with the stroke
+terminations of a Kanji face.
+
+<p><img src="./images/P2F24.gif" alt="Illustration of Panose-2"></p>
+
+<p>The Panose-2 value is not stored inside any known font formats, but
+may be measured.
 
 <h2><a name="truetype-unicode">Deducing Unicode Ranges for TrueType</a></h2>
 
