- From: Daniel Weck via cvs-syncmail <cvsmail@w3.org>
- Date: Wed, 11 May 2011 00:44:42 +0000
- To: public-css-commits@w3.org
Update of /sources/public/csswg/css3-speech
In directory hutz:/tmp/cvs-serv22244
Modified Files:
Overview.html Overview.src.html
Log Message:
minor editorial fixes
Index: Overview.html
===================================================================
RCS file: /sources/public/csswg/css3-speech/Overview.html,v
retrieving revision 1.46
retrieving revision 1.47
diff -u -d -r1.46 -r1.47
--- Overview.html 11 May 2011 00:19:07 -0000 1.46
+++ Overview.html 11 May 2011 00:44:39 -0000 1.47
@@ -270,41 +270,34 @@
<li><a href="#pause-props"><span class=secno>5. </span>Pause properties
</a>
<ul class=toc>
- <li><a href="#pause-props-pause-before"><span class=secno>5.1.
- </span>The ‘<code class=property>pause-before</code>’
- property</a>
-
- <li><a href="#pause-props-pause-after"><span class=secno>5.2. </span>The
- ‘<code class=property>pause-after</code>’ property</a>
+ <li><a href="#pause-props-pause-before-after"><span class=secno>5.1.
+ </span>The ‘<code class=property>pause-before</code>’ and
+ ‘<code class=property>pause-after</code>’ properties</a>
- <li><a href="#pause-props-pause"><span class=secno>5.3. </span>The
+ <li><a href="#pause-props-pause"><span class=secno>5.2. </span>The
‘<code class=property>pause</code>’ shorthand property</a>
- <li><a href="#collapsing"><span class=secno>5.4. </span>Collapsing
+ <li><a href="#collapsing"><span class=secno>5.3. </span>Collapsing
pauses</a>
</ul>
<li><a href="#rest-props"><span class=secno>6. </span>Rest properties</a>
<ul class=toc>
- <li><a href="#rest-props-rest-before"><span class=secno>6.1. </span>The
- ‘<code class=property>rest-before</code>’ property</a>
-
- <li><a href="#rest-props-rest-after"><span class=secno>6.2. </span>The
- ‘<code class=property>rest-after</code>’ property</a>
+ <li><a href="#rest-props-rest-before-after"><span class=secno>6.1.
+ </span>The ‘<code class=property>rest-before</code>’ and
+ ‘<code class=property>rest-after</code>’ properties</a>
- <li><a href="#rest-props-rest"><span class=secno>6.3. </span>The
+ <li><a href="#rest-props-rest"><span class=secno>6.2. </span>The
‘<code class=property>rest</code>’ shorthand property</a>
</ul>
<li><a href="#cue-props"><span class=secno>7. </span>Cue properties</a>
<ul class=toc>
- <li><a href="#cue-props-cue-before"><span class=secno>7.1. </span>The
- ‘<code class=property>cue-before</code>’ property</a>
-
- <li><a href="#cue-props-cue-after"><span class=secno>7.2. </span>The
- ‘<code class=property>cue-after</code>’ property</a>
+ <li><a href="#cue-props-cue-before-after"><span class=secno>7.1.
+ </span>The ‘<code class=property>cue-before</code>’ and
+ ‘<code class=property>cue-after</code>’ properties</a>
- <li><a href="#cue-props-cue"><span class=secno>7.3. </span>The
+ <li><a href="#cue-props-cue"><span class=secno>7.2. </span>The
‘<code class=property>cue</code>’ shorthand property</a>
</ul>
@@ -1000,9 +993,11 @@
<h2 id=pause-props><span class=secno>5. </span>Pause properties</h2>
- <h3 id=pause-props-pause-before><span class=secno>5.1. </span>The ‘<a
- href="#pause-before"><code class=property>pause-before</code></a>’
- property</h3>
+ <h3 id=pause-props-pause-before-after><span class=secno>5.1. </span>The
+ ‘<a href="#pause-before"><code
+ class=property>pause-before</code></a>’ and ‘<a
+ href="#pause-after"><code class=property>pause-after</code></a>’
+ properties</h3>
<table class=propdef summary="name: syntax">
<tbody>
@@ -1050,10 +1045,6 @@
<p>
- <h3 id=pause-props-pause-after><span class=secno>5.2. </span>The ‘<a
- href="#pause-after"><code class=property>pause-after</code></a>’
- property</h3>
-
<table class=propdef summary="name: syntax">
<tbody>
<tr>
@@ -1140,7 +1131,22 @@
between elements.
</dl>
- <h3 id=pause-props-pause><span class=secno>5.3. </span>The ‘<a
+ <p class=note> Note that stronger content boundaries are typically
+ accompanied by pauses. For example, the breaks between paragraphs are
+ typically much more substantial than the breaks between words within a
+ sentence.
+
+ <p> The following example illustrates how the default strengths of prosodic
+ breaks for specific elements (which are defined by the user-agent
+ stylesheet) can be overridden by authored styles:
+
+ <div class=example>
+ <pre>
+p { pause: none } /* pause-before: none; pause-after: none */
+ </pre>
+ </div>
+
+ <h3 id=pause-props-pause><span class=secno>5.2. </span>The ‘<a
href="#pause"><code class=property>pause</code></a>’ shorthand
property</h3>
@@ -1208,22 +1214,7 @@
</pre>
</div>
- <p> The default strengths of prosodic breaks for specific elements are
- defined by the user-agent stylesheet, and can be overridden by authored
- styles, as demonstrated by the example below.
-
- <div class=example>
- <pre>
-p { pause: none } /* pause-before: none; pause-after: none */
- </pre>
- </div>
-
- <p class=note> Note that stronger content boundaries are typically
- accompanied by pauses. For example, the breaks between paragraphs are
- typically much more substantial than the breaks between words within a
- sentence.
-
- <h3 id=collapsing><span class=secno>5.4. </span>Collapsing pauses</h3>
+ <h3 id=collapsing><span class=secno>5.3. </span>Collapsing pauses</h3>
<p> The pause defines the minimum distance of the aural "box" to the aural
"boxes" before and after it. Adjoining pauses are merged by selecting the
@@ -1286,9 +1277,11 @@
<h2 id=rest-props><span class=secno>6. </span>Rest properties</h2>
- <h3 id=rest-props-rest-before><span class=secno>6.1. </span>The ‘<a
- href="#rest-before"><code class=property>rest-before</code></a>’
- property</h3>
+ <h3 id=rest-props-rest-before-after><span class=secno>6.1. </span>The
+ ‘<a href="#rest-before"><code
+ class=property>rest-before</code></a>’ and ‘<a
+ href="#rest-after"><code class=property>rest-after</code></a>’
+ properties</h3>
<table class=propdef summary="name: syntax">
<tbody>
@@ -1336,10 +1329,6 @@
<p>
- <h3 id=rest-props-rest-after><span class=secno>6.2. </span>The ‘<a
- href="#rest-after"><code class=property>rest-after</code></a>’
- property</h3>
-
<table class=propdef summary="name: syntax">
<tbody>
<tr>
@@ -1429,7 +1418,7 @@
class=property>cue-after</code></a>’ content. Adjoining rests are
treated additively, and do not collapse.
- <h3 id=rest-props-rest><span class=secno>6.3. </span>The ‘<a
+ <h3 id=rest-props-rest><span class=secno>6.2. </span>The ‘<a
href="#rest"><code class=property>rest</code></a>’ shorthand
property</h3>
@@ -1491,9 +1480,11 @@
<h2 id=cue-props><span class=secno>7. </span>Cue properties</h2>
- <h3 id=cue-props-cue-before><span class=secno>7.1. </span>The ‘<a
- href="#cue-before"><code class=property>cue-before</code></a>’
- property</h3>
+ <h3 id=cue-props-cue-before-after><span class=secno>7.1. </span>The
+ ‘<a href="#cue-before"><code
+ class=property>cue-before</code></a>’ and ‘<a
+ href="#cue-after"><code class=property>cue-after</code></a>’
+ properties</h3>
<table class=propdef summary="name: syntax">
<tbody>
@@ -1543,10 +1534,6 @@
<p>
- <h3 id=cue-props-cue-after><span class=secno>7.2. </span>The ‘<a
- href="#cue-after"><code class=property>cue-after</code></a>’
- property</h3>
-
<table class=propdef summary="name: syntax">
<tbody>
<tr>
@@ -1598,7 +1585,10 @@
href="#cue-after"><code class=property>cue-after</code></a>’
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>.
+ href="#aural-model">audio "box" model</a>. When a user agent is not able
+ to render the specified auditory icon, it is recommended to produce an
+ alternative cue (e.g., popping up a warning, emitting a warning sound,
+ etc.)
<p class=note> Note that the functionality provided by this property is
related to the <a
@@ -1682,10 +1672,10 @@
}
div.caution { cue-before: url(./audio/caution.wav) 130%; }
- </pre>
+ </pre>
</div>
- <h3 id=cue-props-cue><span class=secno>7.3. </span>The ‘<a
+ <h3 id=cue-props-cue><span class=secno>7.2. </span>The ‘<a
href="#cue"><code class=property>cue</code></a>’ shorthand property</h3>
<table class=propdef summary="name: syntax">
@@ -1743,30 +1733,20 @@
href="#cue-after"><code class=property>cue-after</code></a>’. If
only one value is given, it applies to both properties.
- <p>The following two rules are equivalent:
-
<div class=example>
<pre>
h1
{
cue-before: url(pop.au);
cue-after: url(pop.au);
-}
+}
+/* ...is equivalent to: */
h1
{
cue: url(pop.au);
}
</pre>
</div>
-
- <p>If a user agent cannot render an auditory icon (e.g., the user's
- environment does not permit it), we recommend that it produce an
- alternative audio cue (e.g., popping up a warning, emitting a warning
- sound, etc.)
-
- <p>Authors may also use <a href="#content">content generation
- techniques</a> to insert additional auditory cues based on text instead of
- audio icons.</p>
<!-- Add something here about gc -->
<!-- h2 id="mark-props">Mark properties</h2>
@@ -3329,10 +3309,10 @@
<li>content, <a href="#content-def" title=content><strong>#</strong></a>
- <li>cue, <a href="#cue" title=cue><strong>7.3.</strong></a>
+ <li>cue, <a href="#cue" title=cue><strong>7.2.</strong></a>
<li>cue-after, <a href="#cue-after"
- title=cue-after><strong>7.2.</strong></a>
+ title=cue-after><strong>7.1.</strong></a>
<li>cue-before, <a href="#cue-before"
title=cue-before><strong>7.1.</strong></a>
@@ -3361,10 +3341,10 @@
<li>padding, <a href="#padding-def" title=padding><strong>#</strong></a>
- <li>pause, <a href="#pause" title=pause><strong>5.3.</strong></a>
+ <li>pause, <a href="#pause" title=pause><strong>5.2.</strong></a>
<li>pause-after, <a href="#pause-after"
- title=pause-after><strong>5.2.</strong></a>
+ title=pause-after><strong>5.1.</strong></a>
<li>pause-before, <a href="#pause-before"
title=pause-before><strong>5.1.</strong></a>
@@ -3374,10 +3354,10 @@
<li>renderer, <a href="#renderer" title=renderer><strong>#</strong></a>
- <li>rest, <a href="#rest" title=rest><strong>6.3.</strong></a>
+ <li>rest, <a href="#rest" title=rest><strong>6.2.</strong></a>
<li>rest-after, <a href="#rest-after"
- title=rest-after><strong>6.2.</strong></a>
+ title=rest-after><strong>6.1.</strong></a>
<li>rest-before, <a href="#rest-before"
title=rest-before><strong>6.1.</strong></a>
Index: Overview.src.html
===================================================================
RCS file: /sources/public/csswg/css3-speech/Overview.src.html,v
retrieving revision 1.47
retrieving revision 1.48
diff -u -d -r1.47 -r1.48
--- Overview.src.html 11 May 2011 00:19:07 -0000 1.47
+++ Overview.src.html 11 May 2011 00:44:39 -0000 1.48
@@ -668,7 +668,7 @@
discovers in the source text, and may be implemented as a preprocessing step before passing
the text to the speech synthesizer.</p>
<h2 id="pause-props">Pause properties </h2>
- <h3 id="pause-props-pause-before">The 'pause-before' property</h3>
+ <h3 id="pause-props-pause-before-after">The 'pause-before' and 'pause-after' properties</h3>
<table class="propdef" summary="name: syntax">
<tbody>
<tr>
@@ -722,7 +722,6 @@
</tbody>
</table>
<p> </p>
- <h3 id="pause-props-pause-after">The 'pause-after' property</h3>
<table class="propdef" summary="name: syntax">
<tbody>
<tr>
@@ -802,6 +801,17 @@
time is implementation-dependent. The values indicate monotonically non-decreasing
(conceptually increasing) break strength between elements. </dd>
</dl>
+ <p class="note"> Note that stronger content boundaries are typically accompanied by pauses. For
+ example, the breaks between paragraphs are typically much more substantial than the breaks
+ between words within a sentence. </p>
+ <p> The following example illustrates how the default strengths of prosodic breaks for specific
+ elements (which are defined by the user-agent stylesheet) can be overridden by authored
+ styles: </p>
+ <div class="example">
+ <pre>
+p { pause: none } /* pause-before: none; pause-after: none */
+ </pre>
+ </div>
<h3 id="pause-props-pause">The 'pause' shorthand property</h3>
<table class="propdef" summary="name: syntax">
<tbody>
@@ -865,16 +875,6 @@
h3 { pause-after: 10ms; } /* pause-before: <i>unspecified</i>; pause-after: 10ms */
</pre>
</div>
- <p> The default strengths of prosodic breaks for specific elements are defined by the user-agent
- stylesheet, and can be overridden by authored styles, as demonstrated by the example below. </p>
- <div class="example">
- <pre>
-p { pause: none } /* pause-before: none; pause-after: none */
- </pre>
- </div>
- <p class="note"> Note that stronger content boundaries are typically accompanied by pauses. For
- example, the breaks between paragraphs are typically much more substantial than the breaks
- between words within a sentence. </p>
<h3 id="collapsing">Collapsing pauses</h3>
<p> The pause defines the minimum distance of the aural "box" to the aural "boxes" before and
after it. Adjoining pauses are merged by selecting the strongest named break and the longest
@@ -899,7 +899,7 @@
'cue' to outside the 'cue'. This is not backwards compatible with the informative CSS2.1 Aural
appendix [[!CSS21]].</p>
<h2 id="rest-props">Rest properties</h2>
- <h3 id="rest-props-rest-before">The 'rest-before' property</h3>
+ <h3 id="rest-props-rest-before-after">The 'rest-before' and 'rest-after' properties</h3>
<table class="propdef" summary="name: syntax">
<tbody>
<tr>
@@ -953,7 +953,6 @@
</tbody>
</table>
<p> </p>
- <h3 id="rest-props-rest-after">The 'rest-after' property</h3>
<table class="propdef" summary="name: syntax">
<tbody>
<tr>
@@ -1092,7 +1091,7 @@
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>
+ <h3 id="cue-props-cue-before-after">The 'cue-before' and 'cue-after' properties</h3>
<table class="propdef" summary="name: syntax">
<tbody>
<tr>
@@ -1148,7 +1147,6 @@
</tbody>
</table>
<p> </p>
- <h3 id="cue-props-cue-after">The 'cue-after' property</h3>
<table class="propdef" summary="name: syntax">
<tbody>
<tr>
@@ -1205,7 +1203,9 @@
</table>
<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>
+ >audio "box" model</a>. When a user agent is not able to render the specified auditory icon,
+ it is recommended to produce an alternative cue (e.g., popping up a warning, emitting a
+ warning sound, etc.)</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>
@@ -1272,7 +1272,7 @@
}
div.caution { cue-before: url(./audio/caution.wav) 130%; }
- </pre>
+ </pre>
</div>
<h3 id="cue-props-cue">The 'cue' shorthand property</h3>
<table class="propdef" summary="name: syntax">
@@ -1330,25 +1330,20 @@
<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>
h1
{
cue-before: url(pop.au);
cue-after: url(pop.au);
-}
+}
+/* ...is equivalent to: */
h1
{
cue: url(pop.au);
}
</pre>
</div>
- <p>If a user agent cannot render an auditory icon (e.g., the user's environment does not permit
- it), we recommend that it produce an alternative audio cue (e.g., popping up a warning,
- emitting a warning sound, etc.)</p>
- <p>Authors may also use <a href="#content">content generation techniques</a> to insert
- additional auditory cues based on text instead of audio icons.</p>
<!-- Add something here about gc -->
<!-- h2 id="mark-props">Mark properties</h2>
Received on Wednesday, 11 May 2011 00:44:43 UTC