fixed voice family names (now matches font-family and allows spaces)

added list bullet nesting level announcement.

Author: danielweck

css3-speech/Overview.html

@@ -90,13 +90,13 @@
 
    <h1 id=top>CSS Speech Module</h1>
 
-   <h2 class="no-num no-toc" id=longstatus-date>Editor's Draft 06 June 2011</h2>
+   <h2 class="no-num no-toc" id=longstatus-date>Editor's Draft 07 June 2011</h2>
 
    <dl>
     <dt>This version:
 
     <dd>
-     <!--<a href="http://www.w3.org/TR/2011/WD-css3-speech-20110606">http://www.w3.org/TR/2011/ED-css3-speech-20110606/</a>-->
+     <!--<a href="http://www.w3.org/TR/2011/WD-css3-speech-20110607">http://www.w3.org/TR/2011/ED-css3-speech-20110607/</a>-->
      <a
      href="http://dev.w3.org/csswg/css3-speech">http://dev.w3.org/csswg/css3-speech</a>
 
@@ -454,8 +454,7 @@ <h3 id=example><span class=secno>1.3. </span>CSS Speech Example</h3>
 &lt;p class="peter"&gt;
   &lt;span class="special"&gt;Can you hear me ?&lt;/span&gt;
   I am Peter.
-&lt;/p&gt;
-            </pre>
+&lt;/p&gt;</pre>
   </div>
 
   <h2 id=aural-model><span class=secno>2. </span>The <dfn
@@ -1098,8 +1097,7 @@ <h3 id=pause-props-pause-before-after><span class=secno>5.1. </span>The
 
   <div class=example>
    <pre>
-p { pause: none } /* pause-before: none; pause-after: none */
-            </pre>
+p { pause: none } /* pause-before: none; pause-after: none */</pre>
   </div>
 
   <h3 id=pause-props-pause><span class=secno>5.2. </span>The &lsquo;<a
@@ -1166,8 +1164,7 @@ <h3 id=pause-props-pause><span class=secno>5.2. </span>The &lsquo;<a
    <pre>
 h1 { pause: 20ms; } /* pause-before: 20ms; pause-after: 20ms */
 h2 { pause: 30ms 40ms; } /* pause-before: 30ms; pause-after: 40ms */
-h3 { pause-after: 10ms; } /* pause-before: <i>unspecified</i>; pause-after: 10ms */
-            </pre>
+h3 { pause-after: 10ms; } /* pause-before: <i>unspecified</i>; pause-after: 10ms */</pre>
   </div>
 
   <h3 id=collapsing><span class=secno>5.3. </span>Collapsing pauses</h3>
@@ -1608,8 +1605,7 @@ <h3 id=cue-props-cue-before-after><span class=secno>7.1. </span>The
   cue-after: url(../clips-2/pop.au) 6dB;
 }
 
-div.caution { cue-before: url(./audio/caution.wav) +8dB; }
-      </pre>
+div.caution { cue-before: url(./audio/caution.wav) +8dB; }</pre>
   </div>
 
   <h3 id=cue-props-cue><span class=secno>7.2. </span>The &lsquo;<a
@@ -1681,8 +1677,7 @@ <h3 id=cue-props-cue><span class=secno>7.2. </span>The &lsquo;<a
 h1
 {
   cue: url(pop.au);
-}
-            </pre>
+}</pre>
   </div>
 
   <h2 id=voice-char-props><span class=secno>8. </span>Voice characteristic
@@ -1702,9 +1697,9 @@ <h3 id=voice-props-voice-family><span class=secno>8.1. </span>The &lsquo;<a
     <tr>
      <td> <em>Value:</em>
 
-     <td> [[[&lt;name&gt; | [&lt;age&gt;? &lt;gender&gt;]] &lt;non-negative
-      number&gt;?],]* [[&lt;name&gt; | [&lt;age&gt;? &lt;gender&gt;]]
-      &lt;non-negative number&gt;?] | preserve | inherit
+     <td> [[&lt;name&gt; | [&lt;age&gt;? &lt;gender&gt; &lt;non-negative
+      number&gt;?]],]* [&lt;name&gt; | [&lt;age&gt;? &lt;gender&gt;
+      &lt;non-negative number&gt;?]] | preserve | inherit
 
     <tr>
      <td> <em>Initial:</em>
@@ -1756,11 +1751,51 @@ <h3 id=voice-props-voice-family><span class=secno>8.1. </span>The &lsquo;<a
 
    <dd>
     <p>Values are specific voice instances (e.g., Mike, comedian, mary,
-     carlos, "valley-girl"). For compatibility with SSML, voice names do not
-     contain whitespace characters, and any whitespace characters before or
-     after the voice name are ignored. Values can be quoted, and indeed must
-     be quoted if any of the words that make up the name does not conform to
-     the syntax rules for <a href="#identifier-def">identifiers</a>.</p>
+     carlos2, "valley girl"). Voice names must either be given quoted as <a
+     href="#strings-def">strings</a>, or unquoted as a sequence of one or
+     more <a href="#identifier-def">identifiers</a>.</p>
+
+    <p class=note>Note that as a result, most punctuation characters, or
+     digits at the start of each token, must be escaped in unquoted voice
+     names. For example, the following declarations are invalid:</p>
+
+    <div class=example>
+     <pre>
+voice-family: john/doe; /* forward slash character should be escaped */
+voice-family: john "doe"; /* identifier sequence cannot contain strings */
+voice-family: john!; /* exclamation mark should be escaped */
+voice-family: john@doe; /* "at" character should be escaped */
+voice-family: #john; /* identifier cannot start with hash character */
+voice-family: john 1st; /* identifier cannot start with digit */</pre>
+    </div>
+
+    <p> If a sequence of identifiers is given as a voice name, the computed
+     value is the name converted to a string by joining all the identifiers
+     in the sequence by single spaces.</p>
+
+    <p> Voice names that happen to be the same as the gender keywords
+     (&lsquo;<code class=property>male</code>&rsquo;, &lsquo;<code
+     class=property>female</code>&rsquo; and &lsquo;<code
+     class=property>neutral</code>&rsquo;) or that happen to match the
+     keywords &lsquo;<code class=property>inherit</code>&rsquo; or
+     &lsquo;<code class=property>preserve</code>&rsquo; must be quoted to
+     disambiguate with these keywords. The keywords &lsquo;<code
+     class=property>initial</code>&rsquo; and &lsquo;<code
+     class=property>default</code>&rsquo; are reserved for future use and
+     must also be quoted when used as voice names.</p>
+
+    <p class=note> Note that to avoid mistakes in escaping, it is recommended
+     to quote voice names that contain white space, digits, or punctuation
+     characters other than hyphens. For example:</p>
+
+    <div class=example>
+     <pre>
+voice-family: "john doe", "Henry the-8th";</pre>
+    </div>
+
+    <p class=note> Note that in <a href="#SSML"
+     rel=biblioentry>[SSML]<!--{{!SSML}}--></a>, voice names are
+     space-separated and cannot contain whitespace characters.</p>
 
    <dt> <strong>&lt;age&gt;</strong>
 
@@ -1780,8 +1815,7 @@ <h3 id=voice-props-voice-family><span class=secno>8.1. </span>The &lsquo;<a
    <dt> <strong>&lt;non-negative number&gt;</strong>
 
    <dd>
-    <p>Indicates a preferred variant (e.g. "the second male child voice" or
-     "the third voice named &lsquo;<code class=property>Mike</code>&rsquo;").
+    <p>Indicates a preferred variant (e.g. "the second male child voice").
      Possible values are <a href="#non-negative-number-def">non-negative
      numbers</a> restricted to integers, and excluding zero (i.e. starting
      from 1). The value "1" refers to the first of all matching voices.</p>
@@ -1829,7 +1863,7 @@ <h4 class=no-toc id=voice-props-lang-handling><span class=secno>8.1.1.
 
    <li> If several voices are available for the language of the selected
     content, then the chosen voice is the one that most closely matches the
-    specified gender, age, and preferred voice index. The actual definition
+    specified gender, age, and preferred voice variant. The actual definition
     of "best match" is processor-dependent.
 
    <li> If no voice is available for the language of the selected content, it
@@ -1870,8 +1904,7 @@ <h4 class=no-toc id=voice-props-lang-handling><span class=secno>8.1.1.
   than that corresponding to the class "romeo"
   (which is inherited from the "p" parent element): 
   &lt;span style="voice-family: female;"&gt;Hello sir!&lt;/span&gt;
-&lt;/p&gt;
-            </pre>
+&lt;/p&gt;</pre>
   </div>
 
   <h3 id=voice-props-voice-rate><span class=secno>8.2. </span>The &lsquo;<a
@@ -2085,8 +2118,7 @@ <h3 id=voice-props-voice-pitch><span class=secno>8.3. </span>The &lsquo;<a
 h2 { voice-pitch: +30Hz relative; }
 h2 { voice-pitch: 30Hz relative; } /* identical to the line above */
 h3 { voice-pitch: relative -2st; } /* the swapped keyword placement is a legal syntax */
-h4 { voice-pitch: -2st; } /* Illegal syntax ! ("relative" keyword is missing) */
-            </pre>
+h4 { voice-pitch: -2st; } /* Illegal syntax ! ("relative" keyword is missing) */</pre>
   </div>
 
   <h3 id=voice-props-voice-pitch-range><span class=secno>8.4. </span>The
@@ -2314,8 +2346,7 @@ <h3 id=voice-props-voice-pitch-range><span class=secno>8.4. </span>The
 
 &lt;!-- The lines below demonstrate increasing levels of emphasis: --&gt;
 &lt;p&gt;This is a &lt;span class="normal-emphasis"&gt;big&lt;/span&gt; car!&lt;/p&gt;
-&lt;p&gt;This is a &lt;span class="huge-emphasis"&gt;big&lt;/span&gt; car!!!&lt;/p&gt;
-            </pre>
+&lt;p&gt;This is a &lt;span class="huge-emphasis"&gt;big&lt;/span&gt; car!!!&lt;/p&gt;</pre>
   </div>
 
   <h2 id=duration-props><span class=secno>9. </span>Voice duration property</h2>
@@ -2431,7 +2462,9 @@ <h2 id=lists><span class=secno>10. </span>List items and counters styles</h2>
     <p> For these list item styles, the user-agent defines (possibly based on
      user preferences) what equivalent phrase is spoken or what audio cue is
      played. List items with graphical bullets are therefore announced
-     appropriately in an implementation-dependent manner.</p>
+     appropriately in an implementation-dependent manner. For hierarchical
+     lists structures, it is recommended that user-agents announce the
+     nesting depth of list items.</p>
 
    <dt> <strong>decimal, decimal-leading-zero, lower-roman, upper-roman,
     georgian, armenian</strong>
@@ -2545,8 +2578,7 @@ <h2 id=content><span class=secno>12. </span>Inserted and replaced content</h2>
 abbr { content: attr(title); }
 ...
 
-&lt;abbr title="World Wide Web Consortium"&gt;W3C&lt;/abbr&gt;
-            </pre>
+&lt;abbr title="World Wide Web Consortium"&gt;W3C&lt;/abbr&gt;</pre>
   </div>
 
   <p>In a similar way, text strings in a document can be replaced by a
@@ -2563,8 +2595,7 @@ <h2 id=content><span class=secno>12. </span>Inserted and replaced content</h2>
 
 &lt;div class="hamlet"&gt;
 To be, or not to be: that is the question:
-&lt;/div&gt;
-            </pre>
+&lt;/div&gt;</pre>
   </div>
 
   <p>Furthermore, authors (or users via a user stylesheet) may add some
@@ -2586,8 +2617,7 @@ <h2 id=content><span class=secno>12. </span>Inserted and replaced content</h2>
    <pre>
 ul::before { content: "Start list: "; }
 ul::after  { content: "List end. "; }
-li::before { content: "List item: "; }
-</pre>
+li::before { content: "List item: "; }</pre>
   </div>
 
   <p>Detailed information can be found in the CSS3 Generated and Replaced
@@ -2823,9 +2853,9 @@ <h2 class=no-num id=property-index>Appendix A &mdash; Property index</h2>
     <tr>
      <td><a class=property href="#voice-family">voice-family</a>
 
-     <td>[[[&lt;name&gt; | [&lt;age&gt;? &lt;gender&gt;]] &lt;non-negative
-      number&gt;?],]* [[&lt;name&gt; | [&lt;age&gt;? &lt;gender&gt;]]
-      &lt;non-negative number&gt;?] | preserve | inherit
+     <td>[[&lt;name&gt; | [&lt;age&gt;? &lt;gender&gt; &lt;non-negative
+      number&gt;?]],]* [&lt;name&gt; | [&lt;age&gt;? &lt;gender&gt;
+      &lt;non-negative number&gt;?]] | preserve | inherit
 
      <td>implementation-dependent
 
@@ -3001,6 +3031,11 @@ <h2 class=no-num id=property-index>Appendix A &mdash; Property index</h2>
     href="http://www.w3.org/TR/CSS21/syndata.html#value-def-identifier">
     identifier </a></dfn> &nbsp;&nbsp; <a href="#CSS21"
     rel=biblioentry>[CSS21]<!--{{!CSS21}}--></a>
+
+   <li> <dfn id=strings-def> <a
+    href="http://www.w3.org/TR/CSS21/syndata.html#strings"> strings
+    </a></dfn> &nbsp;&nbsp; <a href="#CSS21"
+    rel=biblioentry>[CSS21]<!--{{!CSS21}}--></a>
   </ul>
 
   <h2 class=no-num id=index>Appendix B &mdash; Index</h2>
@@ -3083,6 +3118,8 @@ <h2 class=no-num id=index>Appendix B &mdash; Index</h2>
    <li>speak-as, <a href="#speak-as" title=speak-as><strong>4.2.</strong></a>
 
 
+   <li>strings, <a href="#strings-def" title=strings><strong>#</strong></a>
+
    <li>style sheet, <a href="#style-sheet" title="style
     sheet"><strong>#</strong></a>
     <ul>
@@ -3375,6 +3412,10 @@ <h2 class=no-num id=changes>Appendix D &mdash; Changes from previous draft</h2>
     class=property>voice-family</code></a>&rsquo; selection algorithm to
     cater for language changes.
 
+   <li>Enabled voice-family names to contain spaces, matching &lsquo;<code
+    class=property>font-family</code>&rsquo; syntax which is based on quoted
+    strings and concatenated identifiers.
+
    <li>Added a new section to define the relationship of this specification
     with CSS2.1.