[css2] kFixed English grammar, lowercased some examples, moved frequency,

bert-github · bert-github · commit 8c175902121f · 2002-04-29T19:15:23.000Z
time and angle types to Appendix A (aural)

--HG--
extra : convert_revision : svn%3A73dc7c4b-06e6-40f3-b4f7-9ed1dbc14bfc/trunk%401871
diff --git a/css2/syndata.src b/css2/syndata.src
@@ -1,6 +1,6 @@
 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
 <html lang="en">
-<!-- $Id: syndata.src,v 2.67 2002-04-22 22:05:22 bbos Exp $ -->
+<!-- $Id: syndata.src,v 2.68 2002-04-29 19:15:23 bbos Exp $ -->
 <HEAD>
 <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
 <TITLE>CSS2 syntax and basic data types</TITLE>
@@ -63,9 +63,12 @@ Lex, in case of multiple matches, the longest match determines the token.
 <TR><TD>INCLUDES	<TD><code>~=</code>
 <TR><TD>DASHMATCH	<TD><code>|=</code>
 <TR><TD>DELIM		<TD><var>any other character not matched by
-the above rules, and not a single or double quote</var>
+the above rules, and neither a single nor a double quote</var>
 </TABLE>
 
+<p>[What should a parser do with unbalanced quotes? Do we give rules
+for how much to ignore after a lonely quote? BB]
+
 <P>The macros in curly braces ({}) above are defined as follows:
 
 <TABLE>
@@ -256,7 +259,7 @@ Assume, for example, that a CSS2 parser encounters this style sheet:
 
 <PRE>
 @import "subs.css";
-H1 { color: blue }
+h1 { color: blue }
 @import "list.css";
 </PRE>
 
@@ -266,7 +269,7 @@ the whole at-rule, effectively reducing the style sheet to:
 
 <PRE>
 @import "subs.css";
-H1 { color: blue }
+h1 { color: blue }
 </PRE>
 </div>
 
@@ -278,9 +281,9 @@ since it occurs inside a '@media' <a href="#block">block</a>.
 @import "subs.css";
 @media print {
   @import "print-main.css";
-  BODY { font-size: 10pt }
+  body { font-size: 10pt }
 }
-H1 {color: blue }
+h1 {color: blue }
 </PRE>
 </div>
 
@@ -386,21 +389,21 @@ groups.</p>
 <div class="example"><p>
 Thus, the following rules:</p>
 <pre>
-H1 { font-weight: bold }
-H1 { font-size: 12pt }
-H1 { line-height: 14pt }
-H1 { font-family: Helvetica }
-H1 { font-variant: normal }
-H1 { font-style: normal }
+h1 { font-weight: bold }
+h1 { font-size: 12px }
+h1 { line-height: 14px }
+h1 { font-family: Helvetica }
+h1 { font-variant: normal }
+h1 { font-style: normal }
 </pre>
 
 <p>are equivalent to:</p>
 
 <pre>
-H1 {
+h1 {
   font-weight: bold;
-  font-size: 12pt;
-  line-height: 14pt;
+  font-size: 12px;
+  line-height: 14px;
   font-family: Helvetica;
   font-variant: normal;
   font-style: normal
@@ -432,10 +435,10 @@ and semantic restrictions on the values it accepts.
 For example, assume a CSS2 parser encounters this style sheet:
 
 <PRE>
-H1 { color: red; font-style: 12pt }  /* Invalid value: 12pt */
-P { color: blue;  font-vendor: any;  /* Invalid prop.: font-vendor */
+h1 { color: red; font-style: 12pt }  /* Invalid value: 12pt */
+p { color: blue;  font-vendor: any;  /* Invalid prop.: font-vendor */
     font-variant: small-caps }
-EM EM { font-style: normal }
+em em { font-style: normal }
 </PRE>
 
 <P> The second declaration on the first line has an invalid value
@@ -445,9 +448,9 @@ class="index-inst" title="ignore"><a href="#ignore">ignore</a></span> these
 declarations, effectively reducing the style sheet to:
 
 <PRE class="example">
-H1 { color: red; }
-P { color: blue;  font-variant: small-caps }
-EM EM { font-style: normal }
+h1 { color: red; }
+p { color: blue;  font-variant: small-caps }
+em em { font-style: normal }
 </PRE>
 </div>
 
@@ -502,21 +505,21 @@ H1 { color: red }
 declaration with an illegal value. For example:
 
 <PRE class="illegal-example">
-IMG { float: left }       /* correct CSS2 */
-IMG { float: left here }  /* "here" is not a value of 'float' */
-IMG { background: "red" } /* keywords cannot be quoted in CSS2 */
-IMG { border-width: 3 }   /* a unit must be specified for length values */
+img { float: left }       /* correct CSS2 */
+img { float: left here }  /* "here" is not a value of 'float' */
+img { background: "red" } /* keywords cannot be quoted in CSS2 */
+img { border-width: 3 }   /* a unit must be specified for length values */
 </PRE>
 
 A CSS2 parser would honor the first rule and
 <span class="index-inst" title="ignore"><a href="#ignore">ignore</a></span>
 the rest, as if the style sheet had been:
 
 <PRE class="example">
-IMG { float: left }
-IMG { }
-IMG { }
-IMG { }
+img { float: left }
+img { }
+img { }
+img { }
 </PRE>
 
 <P>A user agent conforming to a future CSS specification may accept one or
@@ -607,9 +610,9 @@ display to a laser printer).
 
 <div class="example"><P>
 <PRE>
-H1 { margin: 0.5em }      /* em */
-H1 { margin: 1ex }        /* ex */
-P  { font-size: 12px }    /* px */
+h1 { margin: 0.5em }      /* em */
+h1 { margin: 1ex }        /* ex */
+p  { font-size: 12px }    /* px */
 </PRE>
 </div>
 
@@ -632,18 +635,18 @@ an 'ex' is defined even for fonts that don't contain an "x".
 <P>The rule:
 
 <PRE>
-H1 { line-height: 1.2em }
+h1 { line-height: 1.2em }
 </PRE>
 
-<P>means that the line height of H1 elements will be 20% greater
-than the font size of the H1 elements. On the other hand:
+<P>means that the line height of "h1" elements will be 20% greater
+than the font size of the "h1" elements. On the other hand:
 
 <PRE>
-H1 { font-size: 1.2em }
+h1 { font-size: 1.2em }
 </PRE>
 
-<P>means that the font-size of H1 elements will be 20% greater than
-the font size inherited by H1 elements.
+<P>means that the font-size of "h1" elements will be 20% greater than
+the font size inherited by "h1" elements.
 </div>
 
 <P>When specified for the root of the <a href="conform.html#doctree">
@@ -697,15 +700,15 @@ href="cascade.html#computed-value">computed values</a>.</p>
 
 <div class="example"><P> 
 In the following rules, the computed <span
-class="propinst-text-indent">'text-indent'</span> value of H1 elements
-will be 36pt, not 45pt, if H1 is a child of the BODY element.
+class="propinst-text-indent">'text-indent'</span> value of "h1" elements
+will be 36px, not 45px, if "h1" is a child of the "body" element.
 
 <PRE>
-BODY {
-  font-size: 12pt;
-  text-indent: 3em;  /* i.e., 36pt */
+body {
+  font-size: 12px;
+  text-indent: 3em;  /* i.e., 36px */
 }
-H1 { font-size: 15pt }
+h1 { font-size: 15px }
 </PRE>
 </div>
 
@@ -723,11 +726,11 @@ of the output medium are known. The absolute units are:
 
 <div class="example"><P>
 <PRE>
-H1 { margin: 0.5in }      /* inches  */
-H2 { line-height: 3cm }   /* centimeters */
-H3 { word-spacing: 4mm }  /* millimeters */
-H4 { font-size: 12pt }    /* points */
-H4 { font-size: 1pc }     /* picas */
+h1 { margin: 0.5in }      /* inches  */
+h2 { line-height: 3cm }   /* centimeters */
+h3 { word-spacing: 4mm }  /* millimeters */
+h4 { font-size: 12pt }    /* points */
+h4 { font-size: 1pc }     /* picas */
 </PRE>
 </div>
 
@@ -761,13 +764,13 @@ href="cascade.html#initial-value">initial value</a> of that property.
 Since child elements (generally) inherit the <a
 href="cascade.html#computed-value">computed values</a> of their parent, in
 the following example, the children of the P element will inherit a
-value of 12pt for <span
+value of 12px for <span
 class="propinst-line-height">'line-height'</span>, not the percentage
 value (120%):
 
 <PRE>
-P { font-size: 10pt }
-P { line-height: 120% }  /* 120% of 'font-size' */
+p { font-size: 10px }
+p { line-height: 120% }  /* 120% of 'font-size' */
 </PRE>
 </div>
 
@@ -791,7 +794,7 @@ functional notation used to designate URIs in property values is
 
 <div class="example"><P>
 <PRE>
-BODY { background: url("http://www.bg.com/pinkish.gif") }
+body { background: url("http://www.bg.com/pinkish.gif") }
 </PRE>
 </div>
 
@@ -804,7 +807,7 @@ character followed by optional whitespace followed by
 
 <div class="example"><P>An example without quotes:
 <PRE>
-LI { list-style: url(http://www.redballs.com/redball.png) disc }
+li { list-style: url(http://www.redballs.com/redball.png) disc }
 </PRE>
 </div>
 
@@ -983,77 +986,6 @@ adjust foreground colors accordingly.
 </div>
 
 
-<H3>Angles</H3>
-<P>Angle values (denoted by <span class="index-def"
-title="&lt;angle&gt;::definition of"><a
-name="value-def-angle">&lt;angle&gt;</a></span> in the text) are used
-with <a href="./aural.html">aural style sheets</a>.
-
-<P>Their format is a <span class="index-inst"
-title="&lt;number&gt;"><span
-class="value-inst-number">&lt;number&gt;</span></span> immediately
-followed by an angle unit identifier.
-
-<P>Angle unit identifiers are:</p>
-
-<ul>
-<li><strong>deg</strong>: degrees
-<LI><strong>grad</strong>: grads
-<LI><strong>rad</strong>: radians
-</UL>
-
-<p>Angle values may be negative. They should be normalized to the
-range 0-360deg by the user agent. For example, -10deg and 350deg are
-equivalent.
-
-<P>For example, a right angle is '90deg' or '100grad' or
-'1.570796326794897rad'.
-
-<H3>Times</H3>
-
-<P>Time values (denoted by <span class="index-def" title="&lt;time&gt;::definition of"><a name="value-def-time">&lt;time&gt;</a></span> in the
-text) are used with <a href="./aural.html">aural style
-sheets</a>.
-
-<P>Their format is a <span class="index-inst"
-title="&lt;number&gt;"><span
-class="value-inst-number">&lt;number&gt;</span></span> immediately
-followed by a time unit identifier.
-
-<P>Time unit identifiers are:</p>
-
-<UL>
-<LI><strong>ms</strong>: milliseconds
-<LI><strong>s</strong>: seconds
-</UL>
-
-<p>Time values may not be negative.
-
-<H3>Frequencies</H3>
-
-<P>Frequency values (denoted by <span class="index-def"
-title="&lt;frequency&gt;::definition of"><a
-name="value-def-frequency">&lt;frequency&gt;</a></span> in the text)
-are used with <a href="./aural.html">aural cascading style
-sheets</a>.
-
-<P>Their format is a <span class="index-inst"
-title="&lt;number&gt;"><span
-class="value-inst-number">&lt;number&gt;</span></span> immediately
-followed by a frequency unit identifier.
-
-<p>Frequency unit identifiers are:</p>
-
-<ul>
-<li><strong>Hz</strong>: Hertz
-<li><strong>kHz</strong>: kilo Hertz
-</ul>
-
-<p>Frequency values may not be negative.
-
-<P> For example, 200Hz (or 200hz) is a bass sound, and 6kHz (or 6khz)
-is a treble sound.
-
 <h3><a name="strings">Strings</a></H3>
 
 <P><span class="index-def" title="&lt;string&gt;, definition of"><a
@@ -1191,13 +1123,13 @@ for both the "style" attribute and the STYLE element.
 For example, we recommend:</em></p>
 
 <pre class="html-example">
-&lt;SPAN style="voice-family: D\FC rst"&gt;...&lt;/SPAN&gt;
+&lt;SPAN style="font-family: L\FC beck"&gt;...&lt;/SPAN&gt;
 </pre>
 
 <P><em>rather than:</em></p>
 
 <pre class="html-example">
-&lt;SPAN style="voice-family: D&amp;#252;rst"&gt;...&lt;/SPAN&gt;
+&lt;SPAN style="font-family: L&amp;#252;beck"&gt;...&lt;/SPAN&gt;
 </pre>
 </div>
 
