added new pending issues.

removed the descendants restriction for speakability:none and explained the expected behavior with pause collapsing and additive adjacent rests.

Author: danielweck

css3-speech/Overview.html

@@ -38,13 +38,13 @@
 
    <h1 id=top>CSS3 Speech Module</h1>
 
-   <h2 class="no-num no-toc" id=longstatus-date>Editor's Draft 06 February
+   <h2 class="no-num no-toc" id=longstatus-date>Editor's Draft 07 February
     2011</h2>
 
    <dl>
     <dt>This version:
 
-    <dd><!--<a href="http://www.w3.org/TR/2011/WD-css3-speech-20110206">http://www.w3.org/TR/2011/ED-css3-speech-20110206</a>-->
+    <dd><!--<a href="http://www.w3.org/TR/2011/WD-css3-speech-20110207">http://www.w3.org/TR/2011/ED-css3-speech-20110207</a>-->
      <a
      href="http://dev.w3.org/csswg/css3-speech">http://dev.w3.org/csswg/css3-speech</a>
 
@@ -162,7 +162,13 @@ <h2 class="no-num no-toc" id=status>Status of this document</h2>
    CR period if there has not been enough interest from implementers:
 
   <ul>
-   <li><a href="#issue-phonemes">phonemes</a></li>
+   <li><a href="#issue-phonemes">phonemes</a>
+
+   <li><a href="#issue-voice-cues-volume">audio cues volume level relative to
+    voice-volume</a>
+
+   <li><a href="#issue-speakability-name">"speakability" not an ideal name
+    ?</a></li>
    <!-- li><a href="#issue-mark">mark</a></li -->
    <!-- li><a href="#issue-speak_none">speak:none</a></li -->
   </ul>
@@ -456,11 +462,23 @@ <h2 id=mixing-props><span class=secno>4. </span>Mixing properties:
    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. &lsquo;<a href="#voice-volume"><code
+   speech relative to these sources.
+
+  <p> &lsquo;<a href="#voice-volume"><code
    class=property>voice-volume</code></a>&rsquo; 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 &lsquo;<a
    href="#voice-volume"><code class=property>voice-volume</code></a>&rsquo;).
+   <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>Values have the following meanings:</p>
   <!-- dl>
@@ -520,8 +538,11 @@ <h2 id=mixing-props><span class=secno>4. </span>Mixing properties:
    the &lsquo;<a href="#voice-volume"><code
    class=property>voice-volume</code></a>&rsquo; value and may therefore
    generate audio output). The latter requires no time and is not rendered in
-   the aural dimension (including its descendants, which cannot override the
-   inherited &lsquo;<code class=property>none</code>&rsquo; value).
+   the aural dimension
+   <!-- (including its descendants, which cannot override the inherited 'none' value). -->
+   (although descendants may override the &lsquo;<a
+   href="#speakability"><code class=property>speakability</code></a>&rsquo;
+   value and may therefore generate audio output).
 
   <table class=propdef summary="name: syntax">
    <tbody>
@@ -667,6 +688,9 @@ <h2 id=speaking-props><span class=secno>5. </span>Speaking properties:
      <td>speech
   </table>
 
+  <p class=issue id=issue-speakability-name> ISSUE: should the "speakability"
+   property be named differently ? e.g. "speaking"
+
   <p>This property specifies whether text will be rendered aurally.
 
   <p>Values have the following meanings:
@@ -686,10 +710,18 @@ <h2 id=speaking-props><span class=secno>5. </span>Speaking properties:
 
    <dd> This value causes an element (including pauses, cues, rests and
     actual content) to not be rendered (i.e., the element has no effect in
-    the aural dimension). Descendant elements do not get rendered either;
-    this behavior cannot be overridden by setting the &lsquo;<a
-    href="#speakability"><code class=property>speakability</code></a>&rsquo;
-    property on the descendants.
+    the aural dimension).
+    <p class=note> Note that any of the descendants of the affected element
+     are allowed to override this value, so they may actually take part in
+     the aural rendering. 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 adjacent rests.</p>
+    <!--
+Descendant elements do not get rendered either;
+this behavior cannot be overridden by setting the 'speakability' property on the descendants.
+-->
+    
 
    <dt><strong>normal</strong>
 
@@ -708,11 +740,10 @@ <h2 id=speaking-props><span class=secno>5. </span>Speaking properties:
    class=property>normal</code>&rsquo;. In the case of &lsquo;<code
    class=property>normal</code>&rsquo;, this would result in descendants
    being rendered in the aural dimension even though they would not be
-   rendered in the visual space. To ensure that an element <em>and its
-   descendants</em> do not get rendered in the aural dimension, use the
-   &lsquo;<code class=property>none</code>&rsquo; value for the &lsquo;<a
-   href="#speakability"><code class=property>speakability</code></a>&rsquo;
-   property.</p>
+   rendered on the visual canvas.
+   <!-- To ensure that an element <em>and its descendants</em> do not get rendered in the aural dimension,
+use the &lsquo;<code class=property>none</code>&rsquo; value for the &lsquo;<code class=property>speakability</code>&rsquo; property. -->
+   </p>
   <!-- p class="note">
 Note that the value of the &lsquo;<code class=property>visibility</code>&rsquo; property (see [[!CSS3BOX]])
 may affect the computed value of &lsquo;<code class=property>voice-volume</code>&rsquo;, but do not affect the &lsquo;<code class=property>speakability</code>&rsquo; property.

css3-speech/Overview.src.html

@@ -99,6 +99,8 @@ <h2 id="status" class="no-num no-toc">Status of this document</h2>
 implementers:
 <ul>
 <li><a href="#issue-phonemes">phonemes</a></li>
+<li><a href="#issue-voice-cues-volume">audio cues volume level relative to voice-volume</a></li>
+<li><a href="#issue-speakability-name">"speakability" not an ideal name ?</a></li>
 <!-- li><a href="#issue-mark">mark</a></li -->
 <!-- li><a href="#issue-speak_none">speak:none</a></li -->
 </ul>
@@ -266,9 +268,21 @@ <h2 id="mixing-props"><span class="secno">4. </span>Mixing properties:
 <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. 'voice-volume' does not apply to <a href
+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').</p>
+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>
 
@@ -325,7 +339,8 @@ <h2 id="mixing-props"><span class="secno">4. </span>Mixing properties:
 including any pause before and after the element, but no sound is generated
 (although descendants may override the 'voice-volume' value and may therefore generate audio output).
 The latter requires no time and is not rendered in the aural dimension
-(including its descendants, which cannot override the inherited 'none' value).
+<!-- (including its descendants, which cannot override the inherited 'none' value). -->
+(although descendants may override the 'speakability' value and may therefore generate audio output).
 </p>
 
 
@@ -448,6 +463,10 @@ <h2 id="speaking-props"><span class="secno">5. </span>Speaking properties:
 </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>
@@ -464,8 +483,19 @@ <h2 id="speaking-props"><span class="secno">5. </span>Speaking properties:
 This value causes an element
 (including pauses, cues, rests and actual content) 
 to not be rendered (i.e., the element has no effect in the aural dimension).
+<p class="note">
+Note that any of the descendants of the affected element
+are allowed to override this value, so they may actually take part in the aural rendering.
+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 adjacent rests.
+</p>
+<!--
 Descendant elements do not get rendered either;
 this behavior cannot be overridden by setting the 'speakability' property on the descendants.
+-->
 </dd>
 
 <dt><strong>normal</strong></dt>
@@ -477,9 +507,9 @@ <h2 id="speaking-props"><span class="secno">5. </span>Speaking properties:
 <p class="note">
 Note that although the 'none' value of the 'display' property cannot be overridden by descendants of the affected element (see [[!CSS3BOX]]),
 the 'auto' value of 'speakability' can however be overridden by descendants, using either of 'none' or 'normal'.
-In the case of 'normal', this would result in descendants being rendered in the aural dimension even though they would not be rendered in the visual space.
-To ensure that an element <em>and its descendants</em> do not get rendered in the aural dimension,
-use the 'none' value for the 'speakability' property.
+In the case of 'normal', this would result in descendants being rendered in the aural dimension even though they would not be rendered on the visual canvas.
+<!-- To ensure that an element <em>and its descendants</em> do not get rendered in the aural dimension,
+use the 'none' value for the 'speakability' property. -->
 </p>
 
 <!-- p class="note">