renamed 'speakability' to 'speak', 'speak' to 'speak-as'

Author: danielweck

css3-speech/Overview.html

@@ -167,12 +167,9 @@ <h2 class="no-num no-toc" id=status>Status of this document</h2>
     class=property>phonemes</code>&rsquo; property breaks principle of
     content/presentation separation</a>
 
-   <li><a href="#issue-speakability-name">&lsquo;<code
-    class=property>speakability</code>&rsquo; not an ideal property name
-    ?</a>
-
    <li><a href="#issue-lists">handling of list styles, numbered items</a>
   </ul>
+  <!-- li><a href="#issue-speakability-name">'speakability' not an ideal property name ?</a></li -->
   <!-- li><a href="#issue-voice-cues-volume">audio cues volume level relative to voice-volume</a></li -->
   <!-- li><a href="#issue-speak_none">speak:none</a></li -->
 
@@ -203,8 +200,8 @@ <h2 class="no-num no-toc" id=contents>Table of contents</h2>
     class=property>voice-balance</code>&rsquo;</a>
 
    <li><a href="#speaking-props"><span class=secno>5. </span>Speaking
-    properties: &lsquo;<code class=property>speakability</code>&rsquo;,
-    &lsquo;<code class=property>speak</code>&rsquo;</a>
+    properties: &lsquo;<code class=property>speak</code>&rsquo;, &lsquo;<code
+    class=property>speak-as</code>&rsquo;</a>
 
    <li><a href="#pause-props"><span class=secno>6. </span>Pause properties:
     &lsquo;<code class=property>pause-before</code>&rsquo;, &lsquo;<code
@@ -516,19 +513,18 @@ <h2 id=mixing-props><span class=secno>4. </span>Mixing properties:
    &lsquo;<a href="#voice-volume"><code
    class=property>voice-volume</code></a>&rsquo; property has a value of
    &lsquo;<code class=property>silent</code>&rsquo;, and an element whose
-   &lsquo;<a href="#speakability"><code
-   class=property>speakability</code></a>&rsquo; property has the value
-   &lsquo;<code class=property>none</code>&rsquo;. The former takes up the
-   same time as if it had been spoken, including any pause before and after
-   the element, but no sound is generated (although descendants can override
-   the &lsquo;<a href="#voice-volume"><code
+   &lsquo;<a href="#speak"><code class=property>speak</code></a>&rsquo;
+   property has the value &lsquo;<code class=property>none</code>&rsquo;. The
+   former takes up the same time as if it had been spoken, including any
+   pause before and after the element, but no sound is generated (although
+   descendants can override 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 'none' value). -->
-   (although descendants can override the &lsquo;<a
-   href="#speakability"><code class=property>speakability</code></a>&rsquo;
-   value and may therefore generate audio output).
+   (although descendants can override the &lsquo;<a href="#speak"><code
+   class=property>speak</code></a>&rsquo; value and may therefore generate
+   audio output).
 
   <table class=propdef summary="name: syntax">
    <tbody>
@@ -634,9 +630,8 @@ <h2 id=mixing-props><span class=secno>4. </span>Mixing properties:
 <em>does</em> apply to <a href="#cue-props">audio cues</a>.</p -->
 
   <h2 id=speaking-props><span class=secno>5. </span>Speaking properties:
-   &lsquo;<a href="#speakability"><code
-   class=property>speakability</code></a>&rsquo;, &lsquo;<a
-   href="#speak"><code class=property>speak</code></a>&rsquo;</h2>
+   &lsquo;<a href="#speak"><code class=property>speak</code></a>&rsquo;,
+   &lsquo;<a href="#speak-as"><code class=property>speak-as</code></a>&rsquo;</h2>
   <!-- <p>An additional speech property, speak-header, is described in the
 CSS module covering tables.</p> -->
 
@@ -645,7 +640,7 @@ <h2 id=speaking-props><span class=secno>5. </span>Speaking properties:
     <tr>
      <td>Name:
 
-     <td><dfn id=speakability>speakability</dfn>
+     <td><dfn id=speak>speak</dfn>
 
     <tr>
      <td><em>Value:</em>
@@ -682,9 +677,9 @@ <h2 id=speaking-props><span class=secno>5. </span>Speaking properties:
 
      <td>specified value
   </table>
-
-  <p class=issue id=issue-speakability-name> ISSUE: should the "speakability"
-   property be named differently ? e.g. "speaking"
+  <!-- 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.
 
@@ -717,7 +712,7 @@ <h2 id=speaking-props><span class=secno>5. </span>Speaking properties:
      pauses</a> or additive behavior of adjoining rests.</p>
     <!--
 Descendant elements do not get rendered either;
-this behavior cannot be overridden by setting the 'speakability' property on the descendants.
+this behavior cannot be overridden by setting the 'speak' property on the descendants.
 -->
 
 
@@ -731,27 +726,27 @@ <h2 id=speaking-props><span class=secno>5. </span>Speaking properties:
    href="#display-def"><code class=property>display</code></a>&rsquo;
    property cannot be overridden by descendants of the affected element, the
    &lsquo;<code class=property>auto</code>&rsquo; value of &lsquo;<a
-   href="#speakability"><code class=property>speakability</code></a>&rsquo;
-   can however be overridden by descendants, using either of &lsquo;<code
+   href="#speak"><code class=property>speak</code></a>&rsquo; can however be
+   overridden by descendants, using either of &lsquo;<code
    class=property>none</code>&rsquo; or &lsquo;<code
    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 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. -->
+use the 'none' value for the 'speak' property. -->
    </p>
   <!-- p class="note">
 Note that the value of the 'visibility' property
-may affect the computed value of 'voice-volume', but do not affect the 'speakability' property.
+may affect the computed value of 'voice-volume', but do not affect the 'speak' property.
 </p -->
 
   <table class=propdef summary="name: syntax">
    <tbody>
     <tr>
      <td>Name:
 
-     <td><dfn id=speak>speak</dfn>
+     <td><dfn id=speak-as>speak-as</dfn>
 
     <tr>
      <td><em>Value:</em>
@@ -828,11 +823,11 @@ <h2 id=speaking-props><span class=secno>5. </span>Speaking properties:
   </dl>
 
   <p>Speech synthesizers are knowledgeable about what is and what is not a
-   number. The &lsquo;<a href="#speak"><code
-   class=property>speak</code></a>&rsquo; property gives authors the means to
-   control how the synthesizer renders the numbers it discovers in the source
-   text, and may be implemented as a preprocessing step before passing the
-   text to the speech synthesizer.
+   number. The &lsquo;<a href="#speak-as"><code
+   class=property>speak-as</code></a>&rsquo; property gives authors the means
+   to control how the synthesizer renders the numbers it discovers in the
+   source text, and may be implemented as a preprocessing step before passing
+   the text to the speech synthesizer.
 
   <h2 id=pause-props><span class=secno>6. </span>Pause properties: &lsquo;<a
    href="#pause-before"><code class=property>pause-before</code></a>&rsquo;,
@@ -2792,10 +2787,9 @@ <h2 class=no-num id=property-index>Appendix B &mdash; Property index</h2>
     <tr valign=baseline>
      <td><a class=property href="#speak">speak</a>
 
-     <td>normal | spell-out | digits | literal-punctuation | no-punctuation |
-      inherit
+     <td>auto | none | normal | inherit
 
-     <td>normal
+     <td>auto
 
      <td>all elements
 
@@ -2806,11 +2800,12 @@ <h2 class=no-num id=property-index>Appendix B &mdash; Property index</h2>
      <td>speech
 
     <tr valign=baseline>
-     <td><a class=property href="#speakability">speakability</a>
+     <td><a class=property href="#speak-as">speak-as</a>
 
-     <td>auto | none | normal | inherit
+     <td>normal | spell-out | digits | literal-punctuation | no-punctuation |
+      inherit
 
-     <td>auto
+     <td>normal
 
      <td>all elements
 
@@ -3079,8 +3074,7 @@ <h2 class=no-num id=index>Appendix C &mdash; Index</h2>
 
    <li>speak, <a href="#speak" title=speak><strong>5.</strong></a>
 
-   <li>speakability, <a href="#speakability"
-    title=speakability><strong>5.</strong></a>
+   <li>speak-as, <a href="#speak-as" title=speak-as><strong>5.</strong></a>
 
    <li>style sheet, <a href="#style-sheet" title="style
     sheet"><strong>#</strong></a>
@@ -3368,6 +3362,12 @@ <h2 class=no-num id=changes>Appendix F &mdash; Changes from previous draft</h2>
 
    <li>Improved the pause collapsing prose, removed redundant paragraphs.
 
+   <li>Renamed &lsquo;<code class=property>speakability</code>&rsquo; to
+    &lsquo;<a href="#speak"><code class=property>speak</code></a>&rsquo;, and
+    &lsquo;<a href="#speak"><code class=property>speak</code></a>&rsquo; to
+    &lsquo;<a href="#speak-as"><code
+    class=property>speak-as</code></a>&rsquo;.
+
    <li>Added the "auto" value for &lsquo;<a href="#voice-stress"><code
     class=property>voice-stress</code></a>&rsquo;.
 

css3-speech/Overview.src.html

@@ -101,10 +101,10 @@ <h2 id="status" class="no-num no-toc">Status of this document</h2>
 <p>The following issues need to be discussed and require working group resolutions:
 <ul>
 <li><a href="#issue-phonemes">'phonemes' property breaks principle of content/presentation separation</a></li>
-<li><a href="#issue-speakability-name">'speakability' not an ideal property name ?</a></li>
 <li><a href="#issue-lists">handling of list styles, numbered items</a></li>
 </ul>
 
+<!-- li><a href="#issue-speakability-name">'speakability' not an ideal property name ?</a></li -->
 <!-- li><a href="#issue-voice-cues-volume">audio cues volume level relative to voice-volume</a></li -->
 <!-- li><a href="#issue-speak_none">speak:none</a></li -->
 
@@ -353,13 +353,13 @@ <h2 id="mixing-props"><span class="secno">4. </span>Mixing properties:
 
 <p class="note">
 Note that there is a difference between an element whose 'voice-volume' property has a value of 'silent',
-and an element whose 'speakability' property has the value 'none'.
+and an element whose 'speak' property has the value 'none'.
 The former takes up the same time as if it had been spoken,
 including any pause before and after the element, but no sound is generated
 (although descendants can 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). -->
-(although descendants can override the 'speakability' value and may therefore generate audio output).
+(although descendants can override the 'speak' value and may therefore generate audio output).
 </p>
 
 
@@ -451,7 +451,7 @@ <h2 id="mixing-props"><span class="secno">4. </span>Mixing properties:
 <em>does</em> apply to <a href="#cue-props">audio cues</a>.</p -->
 
 <h2 id="speaking-props"><span class="secno">5. </span>Speaking properties:
-'speakability', 'speak'</h2>
+'speak', 'speak-as'</h2>
 
 <!-- <p>An additional speech property, speak-header, is described in the
 CSS module covering tables.</p> -->
@@ -461,7 +461,7 @@ <h2 id="speaking-props"><span class="secno">5. </span>Speaking properties:
 <tbody>
 <tr>
 <td>Name:</td>
-<td><dfn id="speakability">speakability</dfn></td>
+<td><dfn id="speak">speak</dfn></td>
 </tr>
 <tr>
 <td><em>Value:</em></td>
@@ -494,9 +494,9 @@ <h2 id="speaking-props"><span class="secno">5. </span>Speaking properties:
 </tbody>
 </table>
 
-<p class="issue" id="issue-speakability-name">
+<!-- p class="issue" id="issue-speakability-name">
 ISSUE: should the "speakability" property be named differently ? e.g. "speaking"
-</p>
+</p -->
 
 <p>This property specifies whether text will be rendered aurally.</p>
 
@@ -529,7 +529,7 @@ <h2 id="speaking-props"><span class="secno">5. </span>Speaking properties:
 </p>
 <!--
 Descendant elements do not get rendered either;
-this behavior cannot be overridden by setting the 'speakability' property on the descendants.
+this behavior cannot be overridden by setting the 'speak' property on the descendants.
 -->
 </dd>
 
@@ -541,22 +541,22 @@ <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,
-the 'auto' value of 'speakability' can however be overridden by descendants, using either of 'none' or 'normal'.
+the 'auto' value of 'speak' 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 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. -->
+use the 'none' value for the 'speak' property. -->
 </p>
 
 <!-- p class="note">
 Note that the value of the 'visibility' property
-may affect the computed value of 'voice-volume', but do not affect the 'speakability' property.
+may affect the computed value of 'voice-volume', but do not affect the 'speak' property.
 </p -->
 
 <table class="propdef" summary="name: syntax">
 <tbody>
 <tr>
 <td>Name:</td>
-<td><dfn id="speak">speak</dfn></td>
+<td><dfn id="speak-as">speak-as</dfn></td>
 </tr>
 <tr>
 <td><em>Value:</em></td>
@@ -627,7 +627,7 @@ <h2 id="speaking-props"><span class="secno">5. </span>Speaking properties:
 </dl>
 
 <p>Speech synthesizers are knowledgeable about what is and what is
-not a number. The 'speak' property gives authors the means to control
+not a number. The 'speak-as' property gives authors the means to control
 how the synthesizer renders the numbers it discovers in the source
 text, and may be implemented as a preprocessing step before passing
 the text to the speech synthesizer.</p>
@@ -2561,6 +2561,7 @@ <h2 class="no-num" id="changes">Appendix F &mdash; Changes from previous draft</
 <li>Added the missing "Computed value" line to each property definition.</li>
 <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>Renamed 'speakability' to 'speak', and 'speak' to 'speak-as'.</li>
 <li>Added the "auto" value for 'voice-stress'.</li>
 <li>Fixed typos and made other minor edits.</li>
 </ul>