- From: Daniel Weck via cvs-syncmail <cvsmail@w3.org>
- Date: Thu, 28 Apr 2011 21:15:13 +0000
- To: public-css-commits@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>’ property breaks principle of
content/presentation separation</a>
- <li><a href="#issue-speakability-name">‘<code
- class=property>speakability</code>’ 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>’</a>
<li><a href="#speaking-props"><span class=secno>5. </span>Speaking
- properties: ‘<code class=property>speakability</code>’,
- ‘<code class=property>speak</code>’</a>
+ properties: ‘<code class=property>speak</code>’, ‘<code
+ class=property>speak-as</code>’</a>
<li><a href="#pause-props"><span class=secno>6. </span>Pause properties:
‘<code class=property>pause-before</code>’, ‘<code
@@ -516,19 +513,18 @@
‘<a href="#voice-volume"><code
class=property>voice-volume</code></a>’ property has a value of
‘<code class=property>silent</code>’, and an element whose
- ‘<a href="#speakability"><code
- class=property>speakability</code></a>’ property has the value
- ‘<code class=property>none</code>’. 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 ‘<a href="#voice-volume"><code
+ ‘<a href="#speak"><code class=property>speak</code></a>’
+ property has the value ‘<code class=property>none</code>’. 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 ‘<a href="#voice-volume"><code
class=property>voice-volume</code></a>’ 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 ‘<a
- href="#speakability"><code class=property>speakability</code></a>’
- value and may therefore generate audio output).
+ (although descendants can override the ‘<a href="#speak"><code
+ class=property>speak</code></a>’ 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:
- ‘<a href="#speakability"><code
- class=property>speakability</code></a>’, ‘<a
- href="#speak"><code class=property>speak</code></a>’</h2>
+ ‘<a href="#speak"><code class=property>speak</code></a>’,
+ ‘<a href="#speak-as"><code class=property>speak-as</code></a>’</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>’
property cannot be overridden by descendants of the affected element, the
‘<code class=property>auto</code>’ value of ‘<a
- href="#speakability"><code class=property>speakability</code></a>’
- can however be overridden by descendants, using either of ‘<code
+ href="#speak"><code class=property>speak</code></a>’ can however be
+ overridden by descendants, using either of ‘<code
class=property>none</code>’ or ‘<code
class=property>normal</code>’. In the case of ‘<code
class=property>normal</code>’, 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 ‘<a href="#speak"><code
- class=property>speak</code></a>’ 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 ‘<a href="#speak-as"><code
+ class=property>speak-as</code></a>’ 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: ‘<a
href="#pause-before"><code class=property>pause-before</code></a>’,
@@ -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 ‘<code class=property>speakability</code>’ to
+ ‘<a href="#speak"><code class=property>speak</code></a>’, and
+ ‘<a href="#speak"><code class=property>speak</code></a>’ to
+ ‘<a href="#speak-as"><code
+ class=property>speak-as</code></a>’.
+
<li>Added the "auto" value for ‘<a href="#voice-stress"><code
class=property>voice-stress</code></a>’.
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 UTC