further SSML clarifications

Author: danielweck

css3-speech/Overview.html

@@ -284,7 +284,7 @@ <h2 class="no-num no-toc" id=contents>Table of contents</h2>
      <li><a href="#pause-props-pause"><span class=secno>9.2. </span>The
       &lsquo;<code class=property>pause</code>&rsquo; shorthand property</a>
 
-     <li><a href="#collapsing"><span class=secno>9.3. </span>Collapsing
+     <li><a href="#collapsed-pauses"><span class=secno>9.3. </span>Collapsing
       pauses</a>
     </ul>
 
@@ -970,8 +970,8 @@ <h3 id=speaking-props-speak><span class=secno>8.1. </span>The &lsquo;<a
      class=property>none</code>&rsquo; at this level. However, the pauses,
      cues, and rests of the ancestor element remain "deactivated" in the
      aural dimension, and therefore do not contribute to the <a
-     href="#collapsing">collapsing of pauses</a> or additive behavior of
-     adjoining rests.</p>
+     href="#collapsed-pauses">collapsing of pauses</a> or additive behavior
+     of adjoining rests.</p>
 
    <dt> <strong>normal</strong>
 
@@ -1038,16 +1038,18 @@ <h3 id=speaking-props-speak-as><span class=secno>8.2. </span>The &lsquo;<a
 
   <p>The &lsquo;<a href="#speak-as"><code
    class=property>speak-as</code></a>&rsquo; property determines in what
-   manner text gets rendered aurally, based upon a basic predefined list of
-   possible values.
+   manner text gets rendered aurally, based upon a predefined list of
+   possibilities.
 
   <p class=note> Note that the functionality provided by this property is
-   related to the <a
+   conceptually similar to the <a
    href="http://www.w3.org/TR/speech-synthesis11/#edef_say-as"><code>say-as</code>
    element</a> from the SSML markup language <a href="#SSML"
-   rel=biblioentry>[SSML]<!--{{!SSML}}--></a>, whose values are described in
-   the <a href="#SSML-SAYAS"
-   rel=biblioentry>[SSML-SAYAS]<!--{{SSML-SAYAS}}--></a> W3C Note.
+   rel=biblioentry>[SSML]<!--{{!SSML}}--></a> (whose possible values are
+   described in the <a href="#SSML-SAYAS"
+   rel=biblioentry>[SSML-SAYAS]<!--{{SSML-SAYAS}}--></a> W3C Note). Although
+   the design goals are similar, the CSS model is limited to a basic set of
+   pronunciation rules.
 
   <dl>
    <dt> <strong>normal</strong>
@@ -1073,10 +1075,10 @@ <h3 id=speaking-props-speak-as><span class=secno>8.2. </span>The &lsquo;<a
     <p>Speak numbers one digit at a time, for instance, "twelve" would be
      spoken as "one two", and "31" as "three one".</p>
 
-    <p class=note>Speech synthesizers are knowledgeable about what is and
-     what is not a number. The &lsquo;<a href="#speak-as"><code
-     class=property>speak-as</code></a>&rsquo; property enables authors to
-     control how the user-agent renders numbers, and may be implemented as a
+    <p class=note>Speech synthesizers are knowledgeable about what a
+     <em>number</em> is. The &lsquo;<a href="#speak-as"><code
+     class=property>speak-as</code></a>&rsquo; property enables some level of
+     control on how user-agents render numbers, and may be implemented as a
      preprocessing step before passing the text to the actual speech
      synthesizer.</p>
 
@@ -1198,13 +1200,16 @@ <h3 id=pause-props-pause-before-after><span class=secno>9.1. </span>The
    class=property>cue-before</code></a>&rsquo; (or &lsquo;<a
    href="#cue-after"><code class=property>cue-after</code></a>&rsquo;) is
    specified, before (or after) the cue within the <a
-   href="#aural-model">audio "box" model</a>.
+   href="#aural-model">aural "box" model</a>.
 
-  <p class=note> Note that the functionality provided by this property is
-   related to the <a
+  <p class=note> Note that although the functionality provided by this
+   property is similar to the <a
    href="http://www.w3.org/TR/speech-synthesis11/#edef_break"><code>break</code>
    element</a> from the SSML markup language <a href="#SSML"
-   rel=biblioentry>[SSML]<!--{{!SSML}}--></a>.
+   rel=biblioentry>[SSML]<!--{{!SSML}}--></a>, the application of prosodic
+   boundaries within the <a href="#aural-model">aural "box" model</a> of CSS
+   Speech requires special considerations (e.g. <a
+   href="#collapsed-pauses">"collapsed" pauses</a>).
 
   <dl>
    <dt> <strong>&lt;time&gt;</strong>
@@ -1314,7 +1319,7 @@ <h3 id=pause-props-pause><span class=secno>9.2. </span>The &lsquo;<a
 h3 { pause-after: 10ms; } /* pause-before: <i>unspecified</i>; pause-after: 10ms */</pre>
   </div>
 
-  <h3 id=collapsing><span class=secno>9.3. </span>Collapsing pauses</h3>
+  <h3 id=collapsed-pauses><span class=secno>9.3. </span>Collapsing pauses</h3>
 
   <p> The pause defines the minimum distance of the aural "box" to the aural
    "boxes" before and after it. Adjoining pauses are merged by selecting the

css3-speech/Overview.src.html

@@ -623,8 +623,8 @@ <h3 id="speaking-props-speak">The 'speak' property</h3>
           override this value, so descendants can actually take part in the aural rendering despite
           using 'none' at this level. However, the pauses, cues, and rests of the ancestor element
           remain "deactivated" in the aural dimension, and therefore do not contribute to the <a
-            href="#collapsing">collapsing of pauses</a> or additive behavior of adjoining rests.
-        </p>
+            href="#collapsed-pauses">collapsing of pauses</a> or additive behavior of adjoining
+          rests. </p>
       </dd>
       <dt>
         <strong>normal</strong>
@@ -691,11 +691,12 @@ <h3 id="speaking-props-speak-as">The 'speak-as' property</h3>
       </tbody>
     </table>
     <p>The 'speak-as' property determines in what manner text gets rendered aurally, based upon a
-      basic predefined list of possible values.</p>
-    <p class="note"> Note that the functionality provided by this property is related to the <a
-        href="http://www.w3.org/TR/speech-synthesis11/#edef_say-as"><code>say-as</code> element</a>
-      from the SSML markup language [[!SSML]], whose values are described in the [[SSML-SAYAS]] W3C
-      Note. </p>
+      predefined list of possibilities.</p>
+    <p class="note"> Note that the functionality provided by this property is conceptually similar
+      to the <a href="http://www.w3.org/TR/speech-synthesis11/#edef_say-as"><code>say-as</code>
+        element</a> from the SSML markup language [[!SSML]] (whose possible values are described in
+      the [[SSML-SAYAS]] W3C Note). Although the design goals are similar, the CSS model is limited
+      to a basic set of pronunciation rules.</p>
     <dl>
       <dt>
         <strong>normal</strong>
@@ -721,10 +722,10 @@ <h3 id="speaking-props-speak-as">The 'speak-as' property</h3>
       <dd>
         <p>Speak numbers one digit at a time, for instance, "twelve" would be spoken as "one two",
           and "31" as "three one".</p>
-        <p class="note">Speech synthesizers are knowledgeable about what is and what is not a
-          number. The 'speak-as' property enables authors to control how the user-agent renders
-          numbers, and may be implemented as a preprocessing step before passing the text to the
-          actual speech synthesizer.</p>
+        <p class="note">Speech synthesizers are knowledgeable about what a <em>number</em> is. The
+          'speak-as' property enables some level of control on how user-agents render numbers, and
+          may be implemented as a preprocessing step before passing the text to the actual speech
+          synthesizer.</p>
       </dd>
       <dt>
         <strong>literal-punctuation</strong>
@@ -850,10 +851,12 @@ <h3 id="pause-props-pause-before-after">The 'pause-before' and 'pause-after' pro
     <p>The 'pause-before' and 'pause-after' properties specify a prosodic boundary (silence with a
       specific duration) that occurs before (or after) the speech synthesis rendition of the
       selected element, or if any 'cue-before' (or 'cue-after') is specified, before (or after) the
-      cue within the <a href="#aural-model">audio "box" model</a>.</p>
-    <p class="note"> Note that the functionality provided by this property is related to the <a
-        href="http://www.w3.org/TR/speech-synthesis11/#edef_break"><code>break</code> element</a>
-      from the SSML markup language [[!SSML]]. </p>
+      cue within the <a href="#aural-model">aural "box" model</a>.</p>
+    <p class="note"> Note that although the functionality provided by this property is similar to
+      the <a href="http://www.w3.org/TR/speech-synthesis11/#edef_break"><code>break</code>
+        element</a> from the SSML markup language [[!SSML]], the application of prosodic boundaries
+      within the <a href="#aural-model">aural "box" model</a> of CSS Speech requires special
+      considerations (e.g. <a href="#collapsed-pauses">"collapsed" pauses</a>). </p>
     <dl>
       <dt>
         <strong>&lt;time&gt;</strong>
@@ -951,7 +954,7 @@ <h3 id="pause-props-pause">The 'pause' shorthand property</h3>
 h2 { pause: 30ms 40ms; } /* pause-before: 30ms; pause-after: 40ms */
 h3 { pause-after: 10ms; } /* pause-before: <i>unspecified</i>; pause-after: 10ms */</pre>
     </div>
-    <h3 id="collapsing">Collapsing pauses</h3>
+    <h3 id="collapsed-pauses">Collapsing pauses</h3>
     <p> The pause defines the minimum distance of the aural "box" to the aural "boxes" before and
       after it. Adjoining pauses are merged by selecting the strongest named break and the longest
       absolute time interval. For example, "strong" is selected when comparing "strong" and "weak",