W3C home > Mailing lists > Public > public-css-commits@w3.org > April 2011

csswg/css3-speech Overview.html,1.38,1.39 Overview.src.html,1.39,1.40

From: Daniel Weck via cvs-syncmail <cvsmail@w3.org>
Date: Thu, 28 Apr 2011 21:15:13 +0000
To: public-css-commits@w3.org
Message-Id: <E1QFYYL-0007g2-Tf@lionel-hutz.w3.org>
Update of /sources/public/csswg/css3-speech
In directory hutz:/tmp/cvs-serv29132

Modified Files:
	Overview.html Overview.src.html 
Log Message:
renamed 'speakability' to 'speak', 'speak' to 'speak-as'



Index: Overview.html
===================================================================
RCS file: /sources/public/csswg/css3-speech/Overview.html,v
retrieving revision 1.38
retrieving revision 1.39
diff -u -d -r1.38 -r1.39
--- Overview.html	28 Apr 2011 17:29:24 -0000	1.38
+++ Overview.html	28 Apr 2011 21:15:11 -0000	1.39
@@ -167,12 +167,9 @@
     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 @@
     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 @@
    &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 @@
 <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 @@
     <tr>
      <td>Name:
 
-     <td><dfn id=speakability>speakability</dfn>
+     <td><dfn id=speak>speak</dfn>
 
     <tr>
      <td><em>Value:</em>
@@ -682,9 +677,9 @@
 
      <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 @@
      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,19 +726,19 @@
    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">
@@ -751,7 +746,7 @@
     <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 @@
   </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 @@
     <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 @@
      <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 @@
 
    <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 @@
 
    <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;.
 

Index: Overview.src.html
===================================================================
RCS file: /sources/public/csswg/css3-speech/Overview.src.html,v
retrieving revision 1.39
retrieving revision 1.40
diff -u -d -r1.39 -r1.40
--- Overview.src.html	28 Apr 2011 17:29:24 -0000	1.39
+++ Overview.src.html	28 Apr 2011 21:15:11 -0000	1.40
@@ -101,10 +101,10 @@
 <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 @@
 
 <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 @@
 <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 @@
 <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 @@
 </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 @@
 </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 @@
 
 <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 @@
 </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 @@
 <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>
Received on Thursday, 28 April 2011 21:15:15 GMT

This archive was generated by hypermail 2.2.0+W3C-0.50 : Thursday, 28 April 2011 21:15:17 GMT