csswg/css3-speech Overview.html,1.44,1.45 Overview.src.html,1.45,1.46 default.css,1.1,1.2

Update of /sources/public/csswg/css3-speech
In directory hutz:/tmp/cvs-serv14177

Modified Files:
	Overview.html Overview.src.html default.css 
Log Message:
added references to SSML for each property. reworded property intro line wherever necessary.



Index: Overview.html
===================================================================
RCS file: /sources/public/csswg/css3-speech/Overview.html,v
retrieving revision 1.44
retrieving revision 1.45
diff -u -d -r1.44 -r1.45
--- Overview.html	10 May 2011 20:41:36 -0000	1.44
+++ Overview.html	10 May 2011 23:05:19 -0000	1.45
@@ -5,8 +5,7 @@
  <head>
   <title>CSS Speech Module</title>
   <meta content="text/html; charset=utf-8" http-equiv=Content-Type>
-  <link href="http://dev.w3.org/csswg/default.css" rel=stylesheet
-  type="text/css">
+  <link href="../default.css" rel=stylesheet type="text/css">
 
   <style type="text/css">
       *:target
@@ -81,13 +80,13 @@
 
    <h1 id=top>CSS Speech Module</h1>
 
-   <h2 class="no-num no-toc" id=longstatus-date>Editor's Draft 10 May 2011</h2>
+   <h2 class="no-num no-toc" id=longstatus-date>Editor's Draft 11 May 2011</h2>
 
    <dl>
     <dt>This version:
 
     <dd>
-     <!--<a href="http://www.w3.org/TR/2011/WD-css3-speech-20110510">http://www.w3.org/TR/2011/ED-css3-speech-20110510/</a>-->
+     <!--<a href="http://www.w3.org/TR/2011/WD-css3-speech-20110511">http://www.w3.org/TR/2011/ED-css3-speech-20110511/</a>-->
      <a
      href="http://dev.w3.org/csswg/css3-speech">http://dev.w3.org/csswg/css3-speech</a>
      
@@ -572,31 +571,20 @@
   </table>
 
   <p>The &lsquo;<a href="#voice-volume"><code
-   class=property>voice-volume</code></a>&rsquo; refers to the amplitude of
-   the waveform output by the speech synthesiser. This may be mixed with
-   other audio sources, influencing the perceived loudness of synthetic
-   speech relative to these sources.</p>
-  <!-- p>
-            'voice-volume' does not apply to <a href
-            ="#cue-props">audio cues</a> for which there is a separate means
-            to set loudness (absolute, or relative to 'voice-volume').
-            <span class="issue" id="issue-voice-cues-volume">
-            ISSUE: shouldn't audio cues be subjected to the voice-volume,
-            so that an inaudible element gets its entire content (within the aural "box" model) muted as well ?
-            The rationale is that voice-volume:silent is largely equivalent to visibility:hidden,
-            which affects border, padding and spacing (i.e. the entire content with regards to the CSS "visual" box model).
-            The audio cues should therefore only be allowed to set their volume levels <em>relatively</em> to the inherited voice-volume, not with absolute values as these may incorrectly enable audio output when the voice-volume itself is muted.
-            </span>
-            </p -->
-
-  <p>Values have the following meanings:
+   class=property>voice-volume</code></a>&rsquo; property manipulates the
+   amplitude of the audio waveform generated by the speech synthesiser, and
+   is also used to calculate the relative volume level of <a
+   href="#cue-props">audio cues</a> within the <a href="#aural-model">audio
+   "box" model</a>.
 
-  <dl><!-- dt><strong>auto</strong></dt>
-                <dd>
-                Resolves to a computed value of 'medium' when 'visibility' is 'visible',
-                otherwise resolves to a computed value of 'silent'.
-                </dd -->
+  <p class=note> Note that the functionality provided by this property is
+   related to the <a
+   href="http://www.w3.org/TR/speech-synthesis/#edef_prosody"><code>volume</code>
+   attribute of the <code>prosody</code> element</a> from the SSML markup
+   language <a href="#SPEECH-SYNTHESIS"
+   rel=biblioentry>[SPEECH-SYNTHESIS]<!--{{!SPEECH-SYNTHESIS}}--></a>.
 
+  <dl>
    <dt> <strong>&lt;non-negative number&gt;</strong>
 
    <dd>An integer or floating point <a
@@ -651,7 +639,19 @@
    <!-- (including its descendants, which cannot override the inherited 'none' value). -->
    (although descendants can override the &lsquo;<a href="#speak"><code
    class=property>speak</code></a>&rsquo; value and may therefore generate
-   audio output).
+   audio output).</p>
+  <!-- p>
+      'voice-volume' does not apply to <a href
+      ="#cue-props">audio cues</a> for which there is a separate means
+      to set loudness (absolute, or relative to 'voice-volume').
+      <span class="issue" id="issue-voice-cues-volume">
+      ISSUE: shouldn't audio cues be subjected to the voice-volume,
+      so that an inaudible element gets its entire content (within the aural "box" model) muted as well ?
+      The rationale is that voice-volume:silent is largely equivalent to visibility:hidden,
+      which affects border, padding and spacing (i.e. the entire content with regards to the CSS "visual" box model).
+      The audio cues should therefore only be allowed to set their volume levels <em>relatively</em> to the inherited voice-volume, not with absolute values as these may incorrectly enable audio output when the voice-volume itself is muted.
+      </span>
+      </p -->
 
   <h3 id=mixing-props-voice-balance><span class=secno>3.2. </span>The
    &lsquo;<a href="#voice-balance"><code
@@ -702,11 +702,13 @@
   </table>
 
   <p>The &lsquo;<a href="#voice-balance"><code
-   class=property>voice-balance</code></a>&rsquo; property refers to the
-   balance between left and right channels, and presumes a two channel
-   (stereo) model that is widely supported on consumer audio equipment.
+   class=property>voice-balance</code></a>&rsquo; property manipulates the
+   distribution of audio output between left and right channels in
+   stereo-capable sound devices.
 
-  <p>Values have the following meanings:
+  <p class=note> Note that the functionality provided by this property has no
+   match in the SSML markup language <a href="#SPEECH-SYNTHESIS"
+   rel=biblioentry>[SPEECH-SYNTHESIS]<!--{{!SPEECH-SYNTHESIS}}--></a>.
 
   <dl>
    <dt> <strong>&lt;number&gt;</strong>
@@ -809,13 +811,13 @@
 
      <td>specified value
   </table>
-  <!-- p class="issue" id="issue-speakability-name">
-            ISSUE: should the "speakability" property be named differently ? e.g. "speaking"
-            </p -->
 
-  <p>This property specifies whether text will be rendered aurally.
+  <p>The &lsquo;<a href="#speak"><code class=property>speak</code></a>&rsquo;
+   property determines whether or not to render text aurally.
 
-  <p>Values have the following meanings:
+  <p class=note> Note that the functionality provided by this property has no
+   match in the SSML markup language <a href="#SPEECH-SYNTHESIS"
+   rel=biblioentry>[SPEECH-SYNTHESIS]<!--{{!SPEECH-SYNTHESIS}}--></a>.
 
   <dl>
    <dt> <strong>auto</strong>
@@ -920,9 +922,15 @@
      <td>specified value
   </table>
 
-  <p>This property specifies in what manner text gets rendered aurally.
+  <p>The &lsquo;<a href="#speak-as"><code
+   class=property>speak-as</code></a>&rsquo; property determines in what
+   manner text gets rendered aurally.
 
-  <p>Values have the following meanings:
+  <p class=note> Note that the functionality provided by this property is
+   related to the <a
+   href="http://www.w3.org/TR/speech-synthesis/#edef_say-as"><code>say-as</code>
+   element</a> from the SSML markup language <a href="#SPEECH-SYNTHESIS"
+   rel=biblioentry>[SPEECH-SYNTHESIS]<!--{{!SPEECH-SYNTHESIS}}--></a>.
 
   <dl>
    <dt> <strong>normal</strong>
@@ -1064,13 +1072,22 @@
      <td>specified value
   </table>
 
-  <p>These properties specify a pause or prosodic boundary to be observed
-   before (or after) an element or, if any &lsquo;<a href="#cue-before"><code
+  <p>The &lsquo;<a href="#pause-before"><code
+   class=property>pause-before</code></a>&rsquo; and &lsquo;<a
+   href="#pause-after"><code class=property>pause-after</code></a>&rsquo;
+   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 &lsquo;<a href="#cue-before"><code
    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) these.
+   specified, before (or after) the cue within the <a
+   href="#aural-model">audio "box" model</a>.
 
-  <p>Values have the following meanings:
+  <p class=note> Note that the functionality provided by this property is
+   related to the <a
+   href="http://www.w3.org/TR/speech-synthesis/#edef_break"><code>break</code>
+   element</a> from the SSML markup language <a href="#SPEECH-SYNTHESIS"
+   rel=biblioentry>[SPEECH-SYNTHESIS]<!--{{!SPEECH-SYNTHESIS}}--></a>.
 
   <dl>
    <dt> <strong>&lt;time&gt;</strong>
@@ -1148,7 +1165,7 @@
   </table>
 
   <p>The &lsquo;<a href="#pause"><code class=property>pause</code></a>&rsquo;
-   property is a shorthand for setting &lsquo;<a href="#pause-before"><code
+   property is a shorthand property for &lsquo;<a href="#pause-before"><code
    class=property>pause-before</code></a>&rsquo; and &lsquo;<a
    href="#pause-after"><code class=property>pause-after</code></a>&rsquo;. If
    two values are given, the first value is &lsquo;<a
@@ -1341,10 +1358,18 @@
      <td>specified value
   </table>
 
-  <p>These properties specify a rest or prosodic boundary to be observed
-   before (or after) speaking an element's content.
+  <p>The &lsquo;<a href="#rest-before"><code
+   class=property>rest-before</code></a>&rsquo; and &lsquo;<a
+   href="#rest-after"><code class=property>rest-after</code></a>&rsquo;
+   properties specify a prosodic boundary (silence with a specific duration)
+   that occurs before (or after) the speech synthesis rendition of an element
+   within the <a href="#aural-model">audio "box" model</a>.
 
-  <p>Values have the following meanings:
+  <p class=note> Note that the functionality provided by this property is
+   related to the <a
+   href="http://www.w3.org/TR/speech-synthesis/#edef_break"><code>break</code>
+   element</a> from the SSML markup language <a href="#SPEECH-SYNTHESIS"
+   rel=biblioentry>[SPEECH-SYNTHESIS]<!--{{!SPEECH-SYNTHESIS}}--></a>.
 
   <dl>
    <dt> <strong>&lt;time&gt;</strong>
@@ -1429,7 +1454,7 @@
   </table>
 
   <p>The &lsquo;<a href="#rest"><code class=property>rest</code></a>&rsquo;
-   property is a shorthand for setting &lsquo;<a href="#rest-before"><code
+   property is a shorthand for &lsquo;<a href="#rest-before"><code
    class=property>rest-before</code></a>&rsquo; and &lsquo;<a
    href="#rest-after"><code class=property>rest-after</code></a>&rsquo;. If
    two values are given, the first value is &lsquo;<a
@@ -1542,10 +1567,18 @@
      <td>specified value
   </table>
 
-  <p>Auditory icons are another way to distinguish semantic elements. Sounds
-   can be played before and/or after the element to delimit it.
+  <p>The &lsquo;<a href="#cue-before"><code
+   class=property>cue-before</code></a>&rsquo; and &lsquo;<a
+   href="#cue-after"><code class=property>cue-after</code></a>&rsquo;
+   properties specify auditory icons (i.e. prerecorded audio clips) to be
+   played before (or after) the selected element within the <a
+   href="#aural-model">audio "box" model</a>.
 
-  <p>Values have the following meanings:
+  <p class=note> Note that the functionality provided by this property is
+   related to the <a
+   href="http://www.w3.org/TR/speech-synthesis/#edef_audio"><code>audio</code>
+   element</a> from the SSML markup language <a href="#SPEECH-SYNTHESIS"
+   rel=biblioentry>[SPEECH-SYNTHESIS]<!--{{!SPEECH-SYNTHESIS}}--></a>.
 
   <dl>
    <dt> <strong>&lt;uri&gt;</strong>
@@ -1666,7 +1699,7 @@
   </table>
 
   <p>The &lsquo;<a href="#cue"><code class=property>cue</code></a>&rsquo;
-   property is a shorthand for setting &lsquo;<a href="#cue-before"><code
+   property is a shorthand for &lsquo;<a href="#cue-before"><code
    class=property>cue-before</code></a>&rsquo; and &lsquo;<a
    href="#cue-after"><code class=property>cue-after</code></a>&rsquo;. If two
    values are given the first value is &lsquo;<a href="#cue-before"><code
@@ -1925,11 +1958,17 @@
      <td>specified value
   </table>
 
-  <p>The value is a comma-separated, prioritized list of voice family names
-   (note the similarity with &lsquo;<code
-   class=property>font-family</code>&rsquo;).
+  <p>The &lsquo;<a href="#voice-family"><code
+   class=property>voice-family</code></a>&rsquo; property specifies a
+   comma-separated, prioritized list of values that designate speech
+   synthesis voices. (analog to &lsquo;<code
+   class=property>font-family</code>&rsquo; in visual style sheets).
 
-  <p>Values have the following meanings:
+  <p class=note> Note that the functionality provided by this property is
+   related to the <a
+   href="http://www.w3.org/TR/speech-synthesis/#edef_voice"><code>voice</code>
+   element</a> from the SSML markup language <a href="#SPEECH-SYNTHESIS"
+   rel=biblioentry>[SPEECH-SYNTHESIS]<!--{{!SPEECH-SYNTHESIS}}--></a>.
 
   <dl>
    <dt> <strong>&lt;name&gt;</strong>
@@ -2041,13 +2080,19 @@
      <td>specified value
   </table>
 
-  <p>This property controls the speaking rate. The default rate for a voice
-   depends on the language and dialect and on the personality of the voice.
-   The default rate for a voice should be such that it is experienced as a
-   normal speaking rate for the voice when reading aloud text. Since voices
-   are processor-specific, the default rate will be as well.
+  <p>The &lsquo;<a href="#voice-rate"><code
+   class=property>voice-rate</code></a>&rsquo; property manipulates the speed
+   of generated synthetic speech. The default rate for a given &lsquo;<a
+   href="#voice-family"><code class=property>voice-family</code></a>&rsquo;
+   is processor-specific, and depends on the language, dialect and on the
+   "personality" of the voice.
 
-  <p>Values have the following meanings:
+  <p class=note> Note that the functionality provided by this property is
+   related to the <a
+   href="http://www.w3.org/TR/speech-synthesis/#edef_prosody"><code>rate</code>
+   attribute of the <code>prosody</code> element</a> from the SSML markup
+   language <a href="#SPEECH-SYNTHESIS"
+   rel=biblioentry>[SPEECH-SYNTHESIS]<!--{{!SPEECH-SYNTHESIS}}--></a>.
 
   <dl>
    <dt> <strong>&lt;percentage&gt;</strong>
@@ -2116,13 +2161,19 @@
      <td>specified value
   </table>
 
-  <p>Specifies the average pitch (a frequency) of the speaking voice. The
-   average pitch of a voice depends on the &lsquo;<a
+  <p>The &lsquo;<a href="#voice-pitch"><code
+   class=property>voice-pitch</code></a>&rsquo; property specifies the
+   average pitch of generated speech output, and depends on the &lsquo;<a
    href="#voice-family"><code class=property>voice-family</code></a>&rsquo;.
-   For example, the average pitch for a standard male voice is around 120Hz,
-   but for a female voice, it's around 210Hz.
+   For example, the default average pitch for a common male voice is around
+   120Hz, whereas it is around 210Hz for a female voice.
 
-  <p>Values have the following meanings:
+  <p class=note> Note that the functionality provided by this property is
+   related to the <a
+   href="http://www.w3.org/TR/speech-synthesis/#edef_prosody"><code>pitch</code>
+   attribute of the <code>prosody</code> element</a> from the SSML markup
+   language <a href="#SPEECH-SYNTHESIS"
+   rel=biblioentry>[SPEECH-SYNTHESIS]<!--{{!SPEECH-SYNTHESIS}}--></a>.
 
   <dl>
    <dt> <strong>&lt;frequency&gt;</strong>
@@ -2229,14 +2280,20 @@
      <td>specified value
   </table>
 
-  <p>Specifies variation in average pitch. Human languages are spoken with
-   varying inflection and pitch; these variations convey additional meaning
-   and emphasis. Thus, a highly animated voice, i.e., one that is heavily
-   inflected, displays a high pitch range. This property specifies the range
-   over which these variations occur, i.e., how much the fundamental
-   frequency may deviate from the average pitch.
+  <p> The &lsquo;<a href="#voice-pitch-range"><code
+   class=property>voice-pitch-range</code></a>&rsquo; property specifies the
+   variability in average pitch, i.e. how much the fundamental frequency may
+   deviate from the average pitch. The dynamic pitch range of the generated
+   speech output typically increases for a highly animated voice, for example
+   when variations in inflection are used to convey meaning and emphasis in
+   speech.
 
-  <p>Values have the following meanings:
+  <p class=note> Note that the functionality provided by this property is
+   related to the <a
+   href="http://www.w3.org/TR/speech-synthesis/#edef_prosody"><code>range</code>
+   attribute of the <code>prosody</code> element</a> from the SSML markup
+   language <a href="#SPEECH-SYNTHESIS"
+   rel=biblioentry>[SPEECH-SYNTHESIS]<!--{{!SPEECH-SYNTHESIS}}--></a>.
 
   <dl>
    <dt> <strong>&lt;frequency&gt;</strong>
@@ -2293,12 +2350,12 @@
     <tr>
      <td> <em>Value:</em>
 
-     <td>auto | strong | moderate | none | reduced | inherit
+     <td>normal | strong | moderate | none | reduced | inherit
 
     <tr>
      <td> <em>Initial:</em>
 
-     <td>auto
+     <td>normal
 
     <tr>
      <td> <em>Applies&nbsp;to:</em>
@@ -2326,14 +2383,21 @@
      <td>specified value
   </table>
 
-  <p>Indicates the strength of emphasis to be applied. Emphasis is applied
-   using a combination of pitch change, timing changes, loudness and other
-   acoustic differences, and is dependent on the language being spoken.
+  <p>The &lsquo;<a href="#voice-stress"><code
+   class=property>voice-stress</code></a>&rsquo; property manipulates the
+   strength of emphasis, which is normally applied using a combination of
+   pitch change, timing changes, loudness and other acoustic differences. The
+   precise meaning of the values therefore depend on the language being
+   spoken.
 
-  <p>Values have the following meanings:
+  <p class=note> Note that the functionality provided by this property is
+   related to the <a
+   href="http://www.w3.org/TR/speech-synthesis/#edef_emphasis"><code>emphasis</code>
+   element</a> from the SSML markup language <a href="#SPEECH-SYNTHESIS"
+   rel=biblioentry>[SPEECH-SYNTHESIS]<!--{{!SPEECH-SYNTHESIS}}--></a>.
 
   <dl>
-   <dt> <strong>auto</strong>
+   <dt> <strong>normal</strong>
 
    <dd>Represents the default emphasis produced by the speech synthesizer.
 
@@ -2427,14 +2491,21 @@
      <td>specified value
   </table>
 
-  <p> Allows authors to specify how long it should take to render the
-   selected element's content. Unless the value &lsquo;<code
+  <p> The &lsquo;<a href="#voice-duration"><code
+   class=property>voice-duration</code></a>&rsquo; property specifies how
+   long it should take to render the selected element's content (excluding <a
+   href="#cue-props">audio cues</a> ). Unless the value &lsquo;<code
    class=property>auto</code>&rsquo; is specified, this property takes
    precedence over the &lsquo;<a href="#voice-rate"><code
-   class=property>voice-rate</code></a>&rsquo; property and must be used to
+   class=property>voice-rate</code></a>&rsquo; property and should be used to
    determine the speaking rate of the voice.
 
-  <p>Values have the following meanings:
+  <p class=note> Note that the functionality provided by this property is
+   related to the <a
+   href="http://www.w3.org/TR/speech-synthesis/#edef_prosody"><code>duration</code>
+   attribute of the <code>prosody</code> element</a> from the SSML markup
+   language <a href="#SPEECH-SYNTHESIS"
+   rel=biblioentry>[SPEECH-SYNTHESIS]<!--{{!SPEECH-SYNTHESIS}}--></a>.
 
   <dl>
    <dt> <strong>auto</strong>
@@ -3103,9 +3174,9 @@
     <tr valign=baseline>
      <td><a class=property href="#voice-stress">voice-stress</a>
 
-     <td>auto | strong | moderate | none | reduced | inherit
+     <td>normal | strong | moderate | none | reduced | inherit
 
-     <td>auto
+     <td>normal
 
      <td>all elements
 
@@ -3573,7 +3644,7 @@
 
    <li>Improved the pause collapsing prose, removed redundant paragraphs.
 
-   <li>Added the "auto" value for &lsquo;<a href="#voice-stress"><code
+   <li>Added the "normal" value for &lsquo;<a href="#voice-stress"><code
     class=property>voice-stress</code></a>&rsquo;.
 
    <li>Improved document structure by adding sub-sections.

Index: Overview.src.html
===================================================================
RCS file: /sources/public/csswg/css3-speech/Overview.src.html,v
retrieving revision 1.45
retrieving revision 1.46
diff -u -d -r1.45 -r1.46
--- Overview.src.html	10 May 2011 20:41:36 -0000	1.45
+++ Overview.src.html	10 May 2011 23:05:19 -0000	1.46
@@ -3,7 +3,7 @@
   <head>
     <title>CSS Speech Module</title>
     <meta content="text/html; charset=utf-8" http-equiv="Content-Type" />
-    <link href="http://dev.w3.org/csswg/default.css" rel="stylesheet" type="text/css" />
+    <link href="../default.css" rel="stylesheet" type="text/css" />
     <style type="text/css">
       *:target
       {
@@ -313,28 +313,14 @@
         </tr>
       </tbody>
     </table>
-    <p>The 'voice-volume' refers to the amplitude of the waveform output by the speech synthesiser.
-      This may be mixed with other audio sources, influencing the perceived loudness of synthetic
-      speech relative to these sources. </p>
-    <!-- p>
-            'voice-volume' does not apply to <a href
-            ="#cue-props">audio cues</a> for which there is a separate means
-            to set loudness (absolute, or relative to 'voice-volume').
-            <span class="issue" id="issue-voice-cues-volume">
-            ISSUE: shouldn't audio cues be subjected to the voice-volume,
-            so that an inaudible element gets its entire content (within the aural "box" model) muted as well ?
-            The rationale is that voice-volume:silent is largely equivalent to visibility:hidden,
-            which affects border, padding and spacing (i.e. the entire content with regards to the CSS "visual" box model).
-            The audio cues should therefore only be allowed to set their volume levels <em>relatively</em> to the inherited voice-volume, not with absolute values as these may incorrectly enable audio output when the voice-volume itself is muted.
-            </span>
-            </p -->
-    <p>Values have the following meanings:</p>
+    <p>The 'voice-volume' property manipulates the amplitude of the audio waveform generated by the
+      speech synthesiser, and is also used to calculate the relative volume level of <a
+        href="#cue-props">audio cues</a> 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-synthesis/#edef_prosody"><code>volume</code> attribute of
+        the <code>prosody</code> element</a> from the SSML markup language [[!SPEECH-SYNTHESIS]]. </p>
     <dl>
-      <!-- dt><strong>auto</strong></dt>
-                <dd>
-                Resolves to a computed value of 'medium' when 'visibility' is 'visible',
-                otherwise resolves to a computed value of 'silent'.
-                </dd -->
       <dt>
         <strong>&lt;non-negative number&gt;</strong>
       </dt>
@@ -367,6 +353,18 @@
       is not rendered in the aural dimension
       <!-- (including its descendants, which cannot override the inherited 'none' value). -->
       (although descendants can override the 'speak' value and may therefore generate audio output). </p>
+    <!-- p>
+      'voice-volume' does not apply to <a href
+      ="#cue-props">audio cues</a> for which there is a separate means
+      to set loudness (absolute, or relative to 'voice-volume').
+      <span class="issue" id="issue-voice-cues-volume">
+      ISSUE: shouldn't audio cues be subjected to the voice-volume,
+      so that an inaudible element gets its entire content (within the aural "box" model) muted as well ?
+      The rationale is that voice-volume:silent is largely equivalent to visibility:hidden,
+      which affects border, padding and spacing (i.e. the entire content with regards to the CSS "visual" box model).
+      The audio cues should therefore only be allowed to set their volume levels <em>relatively</em> to the inherited voice-volume, not with absolute values as these may incorrectly enable audio output when the voice-volume itself is muted.
+      </span>
+      </p -->
     <h3 id="mixing-props-voice-balance">The 'voice-balance' property</h3>
     <table class="propdef" summary="name: syntax">
       <tbody>
@@ -420,10 +418,10 @@
         </tr>
       </tbody>
     </table>
-    <p>The 'voice-balance' property refers to the balance between left and right channels, and
-      presumes a two channel (stereo) model that is widely supported on consumer audio
-      equipment.</p>
-    <p>Values have the following meanings:</p>
+    <p>The 'voice-balance' property manipulates the distribution of audio output between left and
+      right channels in stereo-capable sound devices.</p>
+    <p class="note"> Note that the functionality provided by this property has no match in the SSML
+      markup language [[!SPEECH-SYNTHESIS]]. </p>
     <dl>
       <dt>
         <strong>&lt;number&gt;</strong>
@@ -520,11 +518,9 @@
         </tr>
       </tbody>
     </table>
-    <!-- p class="issue" id="issue-speakability-name">
-            ISSUE: should the "speakability" property be named differently ? e.g. "speaking"
-            </p -->
-    <p>This property specifies whether text will be rendered aurally.</p>
-    <p>Values have the following meanings:</p>
+    <p>The 'speak' property determines whether or not to render text aurally.</p>
+    <p class="note"> Note that the functionality provided by this property has no match in the SSML
+      markup language [[!SPEECH-SYNTHESIS]]. </p>
     <dl>
       <dt>
         <strong>auto</strong>
@@ -619,8 +615,10 @@
         </tr>
       </tbody>
     </table>
-    <p>This property specifies in what manner text gets rendered aurally.</p>
-    <p>Values have the following meanings:</p>
+    <p>The 'speak-as' property determines in what manner text gets rendered aurally.</p>
+    <p class="note"> Note that the functionality provided by this property is related to the <a
+        href="http://www.w3.org/TR/speech-synthesis/#edef_say-as"><code>say-as</code> element</a>
+      from the SSML markup language [[!SPEECH-SYNTHESIS]]. </p>
     <dl>
       <dt>
         <strong>normal</strong>
@@ -763,9 +761,13 @@
         </tr>
       </tbody>
     </table>
-    <p>These properties specify a pause or prosodic boundary to be observed before (or after) an
-      element or, if any 'cue-before' (or 'cue-after') is specified, before (or after) these.</p>
-    <p>Values have the following meanings:</p>
+    <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-synthesis/#edef_break"><code>break</code> element</a> from
+      the SSML markup language [[!SPEECH-SYNTHESIS]]. </p>
     <dl>
       <dt>
         <strong>&lt;time&gt;</strong>
@@ -839,7 +841,7 @@
         </tr>
       </tbody>
     </table>
-    <p>The 'pause' property is a shorthand for setting 'pause-before' and 'pause-after'. If two
+    <p>The 'pause' property is a shorthand property for 'pause-before' and 'pause-after'. If two
       values are given, the first value is 'pause-before' and the second is 'pause-after'. If only
       one value is given, it applies to both properties.</p>
     <div class="example">
@@ -990,9 +992,12 @@
         </tr>
       </tbody>
     </table>
-    <p>These properties specify a rest or prosodic boundary to be observed before (or after)
-      speaking an element's content.</p>
-    <p>Values have the following meanings:</p>
+    <p>The 'rest-before' and 'rest-after' properties specify a prosodic boundary (silence with a
+      specific duration) that occurs before (or after) the speech synthesis rendition of an element
+      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-synthesis/#edef_break"><code>break</code> element</a> from
+      the SSML markup language [[!SPEECH-SYNTHESIS]]. </p>
     <dl>
       <dt>
         <strong>&lt;time&gt;</strong>
@@ -1069,9 +1074,9 @@
         </tr>
       </tbody>
     </table>
-    <p>The 'rest' property is a shorthand for setting 'rest-before' and 'rest-after'. If two values
-      are given, the first value is 'rest-before' and the second is 'rest-after'. If only one value
-      is given, it applies to both properties.</p>
+    <p>The 'rest' property is a shorthand for 'rest-before' and 'rest-after'. If two values are
+      given, the first value is 'rest-before' and the second is 'rest-after'. If only one value is
+      given, it applies to both properties.</p>
     <h2 id="cue-props">Cue properties</h2>
     <h3 id="cue-props-cue-before">The 'cue-before' property</h3>
     <table class="propdef" summary="name: syntax">
@@ -1184,9 +1189,12 @@
         </tr>
       </tbody>
     </table>
-    <p>Auditory icons are another way to distinguish semantic elements. Sounds can be played before
-      and/or after the element to delimit it. </p>
-    <p>Values have the following meanings:</p>
+    <p>The 'cue-before' and 'cue-after' properties specify auditory icons (i.e. prerecorded audio
+      clips) to be played before (or after) the selected element 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-synthesis/#edef_audio"><code>audio</code> element</a> from
+      the SSML markup language [[!SPEECH-SYNTHESIS]]. </p>
     <dl>
       <dt>
         <strong>&lt;uri&gt;</strong>
@@ -1300,9 +1308,9 @@
         </tr>
       </tbody>
     </table>
-    <p>The 'cue' property is a shorthand for setting 'cue-before' and 'cue-after'. If two values are
-      given the first value is 'cue-before' and the second is 'cue-after'. If only one value is
-      given, it applies to both properties.</p>
+    <p>The 'cue' property is a shorthand for 'cue-before' and 'cue-after'. If two values are given
+      the first value is 'cue-before' and the second is 'cue-after'. If only one value is given, it
+      applies to both properties.</p>
     <p>The following two rules are equivalent:</p>
     <div class="example">
       <pre>
@@ -1552,9 +1560,11 @@
         </tr>
       </tbody>
     </table>
-    <p>The value is a comma-separated, prioritized list of voice family names (note the similarity
-      with 'font-family').</p>
-    <p>Values have the following meanings:</p>
+    <p>The 'voice-family' property specifies a comma-separated, prioritized list of values that
+      designate speech synthesis voices. (analog to 'font-family' in visual style sheets).</p>
+    <p class="note"> Note that the functionality provided by this property is related to the <a
+        href="http://www.w3.org/TR/speech-synthesis/#edef_voice"><code>voice</code> element</a> from
+      the SSML markup language [[!SPEECH-SYNTHESIS]]. </p>
     <dl>
       <dt>
         <strong>&lt;name&gt;</strong>
@@ -1652,11 +1662,12 @@
         </tr>
       </tbody>
     </table>
-    <p>This property controls the speaking rate. The default rate for a voice depends on the
-      language and dialect and on the personality of the voice. The default rate for a voice should
-      be such that it is experienced as a normal speaking rate for the voice when reading aloud
-      text. Since voices are processor-specific, the default rate will be as well.</p>
-    <p>Values have the following meanings:</p>
+    <p>The 'voice-rate' property manipulates the speed of generated synthetic speech. The default
+      rate for a given 'voice-family' is processor-specific, and depends on the language, dialect
+      and on the "personality" of the voice.</p>
+    <p class="note"> Note that the functionality provided by this property is related to the <a
+        href="http://www.w3.org/TR/speech-synthesis/#edef_prosody"><code>rate</code> attribute of
+        the <code>prosody</code> element</a> from the SSML markup language [[!SPEECH-SYNTHESIS]]. </p>
     <dl>
       <dt>
         <strong>&lt;percentage&gt;</strong>
@@ -1726,10 +1737,12 @@
         </tr>
       </tbody>
     </table>
-    <p>Specifies the average pitch (a frequency) of the speaking voice. The average pitch of a voice
-      depends on the 'voice-family'. For example, the average pitch for a standard male voice is
-      around 120Hz, but for a female voice, it's around 210Hz.</p>
-    <p>Values have the following meanings:</p>
+    <p>The 'voice-pitch' property specifies the average pitch of generated speech output, and
+      depends on the 'voice-family'. For example, the default average pitch for a common male voice
+      is around 120Hz, whereas it is around 210Hz for a female voice.</p>
+    <p class="note"> Note that the functionality provided by this property is related to the <a
+        href="http://www.w3.org/TR/speech-synthesis/#edef_prosody"><code>pitch</code> attribute of
+        the <code>prosody</code> element</a> from the SSML markup language [[!SPEECH-SYNTHESIS]]. </p>
     <dl>
       <dt>
         <strong>&lt;frequency&gt;</strong>
@@ -1833,12 +1846,13 @@
         </tr>
       </tbody>
     </table>
-    <p>Specifies variation in average pitch. Human languages are spoken with varying inflection and
-      pitch; these variations convey additional meaning and emphasis. Thus, a highly animated voice,
-      i.e., one that is heavily inflected, displays a high pitch range. This property specifies the
-      range over which these variations occur, i.e., how much the fundamental frequency may deviate
-      from the average pitch.</p>
-    <p>Values have the following meanings:</p>
+    <p> The 'voice-pitch-range' property specifies the variability in average pitch, i.e. how much
+      the fundamental frequency may deviate from the average pitch. The dynamic pitch range of the
+      generated speech output typically increases for a highly animated voice, for example when
+      variations in inflection are used to convey meaning and emphasis in speech. </p>
+    <p class="note"> Note that the functionality provided by this property is related to the <a
+        href="http://www.w3.org/TR/speech-synthesis/#edef_prosody"><code>range</code> attribute of
+        the <code>prosody</code> element</a> from the SSML markup language [[!SPEECH-SYNTHESIS]]. </p>
     <dl>
       <dt>
         <strong>&lt;frequency&gt;</strong>
@@ -1890,13 +1904,13 @@
           <td>
             <em>Value:</em>
           </td>
-          <td>auto | strong | moderate | none | reduced | inherit</td>
+          <td>normal | strong | moderate | none | reduced | inherit</td>
         </tr>
         <tr>
           <td>
             <em>Initial:</em>
           </td>
-          <td>auto</td>
+          <td>normal</td>
         </tr>
         <tr>
           <td>
@@ -1930,13 +1944,15 @@
         </tr>
       </tbody>
     </table>
-    <p>Indicates the strength of emphasis to be applied. Emphasis is applied using a combination of
-      pitch change, timing changes, loudness and other acoustic differences, and is dependent on the
-      language being spoken. </p>
-    <p>Values have the following meanings:</p>
+    <p>The 'voice-stress' property manipulates the strength of emphasis, which is normally applied
+      using a combination of pitch change, timing changes, loudness and other acoustic differences.
+      The precise meaning of the values therefore depend on the language being spoken. </p>
+    <p class="note"> Note that the functionality provided by this property is related to the <a
+        href="http://www.w3.org/TR/speech-synthesis/#edef_emphasis"><code>emphasis</code>
+        element</a> from the SSML markup language [[!SPEECH-SYNTHESIS]]. </p>
     <dl>
       <dt>
-        <strong>auto</strong>
+        <strong>normal</strong>
       </dt>
       <dd>Represents the default emphasis produced by the speech synthesizer.</dd>
       <dt>
@@ -2031,10 +2047,13 @@
         </tr>
       </tbody>
     </table>
-    <p> Allows authors to specify how long it should take to render the selected element's content.
-      Unless the value 'auto' is specified, this property takes precedence over the 'voice-rate'
-      property and must be used to determine the speaking rate of the voice. </p>
-    <p>Values have the following meanings:</p>
+    <p> The 'voice-duration' property specifies how long it should take to render the selected
+      element's content (excluding <a href="#cue-props">audio cues</a> ). Unless the value 'auto' is
+      specified, this property takes precedence over the 'voice-rate' property and should be used to
+      determine the speaking rate of the voice. </p>
+    <p class="note"> Note that the functionality provided by this property is related to the <a
+        href="http://www.w3.org/TR/speech-synthesis/#edef_prosody"><code>duration</code> attribute
+        of the <code>prosody</code> element</a> from the SSML markup language [[!SPEECH-SYNTHESIS]]. </p>
     <dl>
       <dt>
         <strong>auto</strong>
@@ -2616,7 +2635,7 @@
       <li>Cleaned-up the list of module dependencies, and removed redundant "module dependencies"
         section.</li>
       <li>Improved the pause collapsing prose, removed redundant paragraphs.</li>
-      <li>Added the "auto" value for 'voice-stress'.</li>
+      <li>Added the "normal" value for 'voice-stress'.</li>
       <li>Improved document structure by adding sub-sections.</li>
       <li>Fixed typos and made other minor edits.</li>
     </ul>

Index: default.css
===================================================================
RCS file: /sources/public/csswg/css3-speech/default.css,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -d -r1.1 -r1.2
--- default.css	1 Sep 2010 17:44:06 -0000	1.1
+++ default.css	10 May 2011 23:05:19 -0000	1.2
@@ -33,7 +33,7 @@
 
 body {counter-reset: exampleno figure}
 
-h2, h3, h5, h6 { margin-top: 2em }
+/* Pagination */
 h1, h2, h3, h4, h5, h6 { page-break-after: avoid; font-family: inherit }
 div.figure, div.sidefigure, pre, table.propdef, table.propdef-extra,
 div.example { page-break-inside: avoid }
@@ -41,6 +41,14 @@
 
 span.id {float: right; font-weight: bold}
 
+/* General Structural Markup */
+h2, h3, h5, h6 {
+    margin-top: 2em;
+}
+h1 + h2 {
+    margin-top: 0;
+}
+
 p, p.testlink + p, p.mtb {
     text-indent: 0;
     margin-bottom: 0;
@@ -54,10 +62,6 @@
     margin-top: 0
 }
 
-h1 + h2 {
-    margin-top: 0;
-}
-
 pre {
     text-align: left; /* fixes justification in Mac IE 5 */
     text-indent: 0;   /* fixes indent in Mac Netscape 6 */
@@ -106,6 +110,8 @@
 ul.indexlist li { margin-left: 0; list-style: none }
 ul.indexlist li li { margin-left: 1em }
 
+/* Examples */
+
 .example {
     counter-increment: exampleno;
 }
@@ -151,6 +157,7 @@
     margin: 1em 0;
     border: thin solid #999;
     position: relative;
+    clear: both;
 }
 pre.example, pre.illegal-example, pre.html,
 pre.illegal-html, pre.xml, pre.illegal-xml {
@@ -184,19 +191,29 @@
 code.xml { color: #600 }	/* inline XML */
 .property { font: inherit; }	/* name of a CSS property (SPAN) */
 .descriptor { }			/* name of a CSS descriptor (SPAN) */
-.issue { color: #c00 }		/* editorial remark, open issue */
 .type { font-style: italic }	/* A <type> value for a property */
 
 dfn { font-weight: bolder; /*font-size: 1em*/ }
 
+/* Open issue / editorial remark; not intended for a final publication */
+
+.issue { color: #c00 }
+.issue:before {
+  content: "Issue:";
+  border: 3px double #c00;
+  background: #c00;
+  background-clip: padding-box;
+  color: white;
+  margin: 0.25em;
+  padding: 0 0.25em;
+}
+
 /* Class note is a non-normative note. May be inline or a P or DIV */
 .note {
     color: green
 }
-/*
-p.note:before, span.note:before { content: "\25B6\A0" }
-div.note > p:first-child:before { content: "\25B6\A0" }
-*/
+p.note:before, span.note:before { content: "\25B6" " " }
+div.note > p:first-child:before { content: "\25B6" " " }
 
 .normref { color: red }	
 .informref { color: green }	
@@ -374,6 +391,17 @@
     background: #005A9C;
     color: white
 }
+
+/* A footnote at the bottom of a propdef */
+table.propdef td.footnote {padding-top: 0.6em; width: auto}
+table.propdef td.footnote:before {
+  content: " ";
+  display: block;
+  height: 0.6em;
+  width: 4em;
+  border-top: thin solid
+}
+
 /* table.propdef tr:first-child td { padding-top: 0.1em; padding-bottom: 0.1em } */
 
 /* This would replace :first-child for Opera, but it confuses WinIE :-( */

Received on Tuesday, 10 May 2011 23:05:29 UTC