Skip to content

Commit d64cbaf

Browse files
committed
prose cleanup
1 parent a6c722e commit d64cbaf

2 files changed

Lines changed: 54 additions & 63 deletions

File tree

css3-speech/Overview.html

Lines changed: 29 additions & 36 deletions
Original file line numberDiff line numberDiff line change
@@ -2163,14 +2163,6 @@ <h3 id=voice-props-voice-pitch><span class=secno>10.3. </span>The &lsquo;<a
21632163
pitch of the output). For example, the common pitch for a male voice is
21642164
around 120Hz, whereas it is around 210Hz for a female voice.
21652165

2166-
<p> Speech-capable user agents are likely to support a specific range of
2167-
values rather than the full range of possible calculated numerical values
2168-
for frequencies. The actual values in user agents may therefore be clamped
2169-
to implementation-dependent minimum and maximum boundaries. For example:
2170-
although the 0Hz frequency can be legitimately calculated, it may be
2171-
clamped to a more meaningful value in the context of the speech
2172-
synthesizer.
2173-
21742166
<p class=note> Note that the functionality provided by this property is
21752167
related to the <a
21762168
href="http://www.w3.org/TR/speech-synthesis11/#edef_prosody"><code>pitch</code>
@@ -2189,16 +2181,14 @@ <h3 id=voice-props-voice-pitch><span class=secno>10.3. </span>The &lsquo;<a
21892181
value represents an decrement, and a positive value represents an
21902182
increment (relative to the inherited value). For example, "2kHz" is a
21912183
positive offset (strictly equivalent to "+2kHz"), and "+2kHz absolute"
2192-
is an absolute frequency (strictly equivalent to "2kHz absolute").
2193-
Computed absolute frequency values that are negative are clamped to zero
2194-
Hertz.</p>
2184+
is an absolute frequency (strictly equivalent to "2kHz absolute").</p>
21952185

21962186
<dt> <strong>absolute</strong>
21972187

21982188
<dd>
2199-
<p> This keyword specifies that the provided frequency is expressed as an
2200-
absolute, positive value. When a negative value is provided, it is
2201-
clamped to zero.</p>
2189+
<p> This keyword specifies that the provided frequency represents an
2190+
absolute value. If a negative frequency is specified, the computed
2191+
frequency will be zero.</p>
22022192

22032193
<dt> <strong>&lt;semitones&gt;</strong>
22042194

@@ -2209,9 +2199,7 @@ <h3 id=voice-props-voice-pitch><span class=secno>10.3. </span>The &lsquo;<a
22092199
(semitones). A semitone is half of a tone (a half step) on the standard
22102200
diatonic scale. As such, a semitone doesn't correspond to a fixed
22112201
frequency: the ratio between two consecutive frequencies separated by
2212-
exactly one semitone is the twelfth root of two (approximately 1.05946).
2213-
Computed absolute frequency values that are negative are clamped to zero
2214-
Hertz.</p>
2202+
exactly one semitone is the twelfth root of two (approximately 1.05946).</p>
22152203

22162204
<dt> <strong>&lt;percentage&gt;</strong>
22172205

@@ -2223,8 +2211,7 @@ <h3 id=voice-props-voice-pitch><span class=secno>10.3. </span>The &lsquo;<a
22232211
to (from) the inherited value. For example, 50% (which is equivalent to
22242212
+50%) with a inherited value of 200Hz results in <code>200 +
22252213
(200*0.5)</code> = 300Hz. Conversely, -50% results in
2226-
<code>200-(200*0.5)</code> = 100Hz. Computed absolute frequency values
2227-
that are negative are clamped to zero Hertz.</p>
2214+
<code>200-(200*0.5)</code> = 100Hz.</p>
22282215

22292216
<dt><strong>x-low</strong>, <strong>low</strong>, <strong>medium</strong>,
22302217
<strong>high</strong>, <strong>x-high</strong>
@@ -2234,6 +2221,15 @@ <h3 id=voice-props-voice-pitch><span class=secno>10.3. </span>The &lsquo;<a
22342221
implementation and voice specific.</p>
22352222
</dl>
22362223

2224+
<p> Computed absolute frequency values that are negative are clamped to
2225+
zero Hertz. Speech-capable user agents are likely to support a specific
2226+
range of values rather than the full range of possible calculated
2227+
numerical values for frequencies. The actual values in user agents may
2228+
therefore be clamped to implementation-dependent minimum and maximum
2229+
boundaries. For example: although the 0Hz frequency can be legitimately
2230+
calculated, it may be clamped to a more meaningful value in the context of
2231+
the speech synthesizer.
2232+
22372233
<div class=example>
22382234
<p>Examples of property values:</p>
22392235

@@ -2308,14 +2304,6 @@ <h3 id=voice-props-voice-range><span class=secno>10.4. </span>The &lsquo;<a
23082304
to convey meaning and emphasis in speech. Typically, a low range produces
23092305
a flat, monotonic voice, whereas a high range produces an animated voice.
23102306

2311-
<p> Speech-capable user agents are likely to support a specific range of
2312-
values rather than the full range of possible calculated numerical values
2313-
for frequencies. The actual values in user agents may therefore be clamped
2314-
to implementation-dependent minimum and maximum boundaries. For example:
2315-
although the 0Hz frequency can be legitimately calculated, it may be
2316-
clamped to a more meaningful value in the context of the speech
2317-
synthesizer.
2318-
23192307
<p class=note> Note that the functionality provided by this property is
23202308
related to the <a
23212309
href="http://www.w3.org/TR/speech-synthesis11/#edef_prosody"><code>range</code>
@@ -2334,16 +2322,14 @@ <h3 id=voice-props-voice-range><span class=secno>10.4. </span>The &lsquo;<a
23342322
value represents an decrement, and a positive value represents an
23352323
increment (relative to the inherited value). For example, "2kHz" is a
23362324
positive offset (strictly equivalent to "+2kHz"), and "+2kHz absolute"
2337-
is an absolute frequency (strictly equivalent to "2kHz absolute").
2338-
Computed absolute frequency values that are negative are clamped to zero
2339-
Hertz.</p>
2325+
is an absolute frequency (strictly equivalent to "2kHz absolute").</p>
23402326

23412327
<dt> <strong>absolute</strong>
23422328

23432329
<dd>
23442330
<p> This keyword specifies that the provided frequency is expressed as an
2345-
absolute, positive value. When a negative value is provided, it is
2346-
clamped to zero.</p>
2331+
absolute, positive value. If a negative frequency is specified, the
2332+
computed frequency will be zero.</p>
23472333

23482334
<dt> <strong>&lt;semitones&gt;</strong>
23492335

@@ -2355,8 +2341,7 @@ <h3 id=voice-props-voice-range><span class=secno>10.4. </span>The &lsquo;<a
23552341
diatonic scale. As such, a semitone doesn't correspond to a fixed
23562342
frequency: the ratio between two consecutive frequencies separated by
23572343
exactly one semitone is the twelfth root of two (approximately 1.05946).
2358-
Computed absolute frequency values that are negative are clamped to zero
2359-
Hertz.</p>
2344+
</p>
23602345

23612346
<dt> <strong>&lt;percentage&gt;</strong>
23622347

@@ -2368,8 +2353,7 @@ <h3 id=voice-props-voice-range><span class=secno>10.4. </span>The &lsquo;<a
23682353
to (from) the inherited frequency value. For example, 50% (which is
23692354
equivalent to +50%) with a inherited value of 200Hz results in <code>200
23702355
+ (200*0.5)</code> = 300Hz. Conversely, -50% results in
2371-
<code>200-(200*0.5)</code> = 100Hz. Computed absolute frequency values
2372-
that are negative are clamped to zero Hertz.</p>
2356+
<code>200-(200*0.5)</code> = 100Hz.</p>
23732357

23742358
<dt><strong>x-low</strong>, <strong>low</strong>, <strong>medium</strong>,
23752359
<strong>high</strong> and <strong>x-high</strong>
@@ -2379,6 +2363,15 @@ <h3 id=voice-props-voice-range><span class=secno>10.4. </span>The &lsquo;<a
23792363
implementation and language-dependent.</p>
23802364
</dl>
23812365

2366+
<p> Computed absolute frequency values that are negative are clamped to
2367+
zero Hertz. Speech-capable user agents are likely to support a specific
2368+
range of values rather than the full range of possible calculated
2369+
numerical values for frequencies. The actual values in user agents may
2370+
therefore be clamped to implementation-dependent minimum and maximum
2371+
boundaries. For example: although the 0Hz frequency can be legitimately
2372+
calculated, it may be clamped to a more meaningful value in the context of
2373+
the speech synthesizer.
2374+
23822375
<div class=example>
23832376
<p>Examples of inherited values:</p>
23842377

css3-speech/Overview.src.html

Lines changed: 25 additions & 27 deletions
Original file line numberDiff line numberDiff line change
@@ -1714,12 +1714,6 @@ <h3 id="voice-props-voice-pitch">The 'voice-pitch' property</h3>
17141714
common pitch for a male voice is around 120Hz, whereas it is around 210Hz for a female
17151715
voice.</p>
17161716

1717-
<p> Speech-capable user agents are likely to support a specific range of values rather than the
1718-
full range of possible calculated numerical values for frequencies. The actual values in user
1719-
agents may therefore be clamped to implementation-dependent minimum and maximum boundaries.
1720-
For example: although the 0Hz frequency can be legitimately calculated, it may be clamped to a
1721-
more meaningful value in the context of the speech synthesizer. </p>
1722-
17231717
<p class="note"> Note that the functionality provided by this property is related to the <a
17241718
href="http://www.w3.org/TR/speech-synthesis11/#edef_prosody"><code>pitch</code> attribute of
17251719
the <code>prosody</code> element</a> from the SSML markup language [[!SSML]]. </p>
@@ -1733,15 +1727,14 @@ <h3 id="voice-props-voice-pitch">The 'voice-pitch' property</h3>
17331727
is used. Otherwise (when the 'absolute' keyword is not used), a negative value represents
17341728
an decrement, and a positive value represents an increment (relative to the inherited
17351729
value). For example, "2kHz" is a positive offset (strictly equivalent to "+2kHz"), and
1736-
"+2kHz absolute" is an absolute frequency (strictly equivalent to "2kHz absolute").
1737-
Computed absolute frequency values that are negative are clamped to zero Hertz. </p>
1730+
"+2kHz absolute" is an absolute frequency (strictly equivalent to "2kHz absolute"). </p>
17381731
</dd>
17391732
<dt>
17401733
<strong>absolute</strong>
17411734
</dt>
17421735
<dd>
1743-
<p> This keyword specifies that the provided frequency is expressed as an absolute, positive
1744-
value. When a negative value is provided, it is clamped to zero. </p>
1736+
<p> This keyword specifies that the provided frequency represents an absolute value. If a
1737+
negative frequency is specified, the computed frequency will be zero. </p>
17451738
</dd>
17461739
<dt>
17471740
<strong>&lt;semitones&gt;</strong>
@@ -1752,8 +1745,7 @@ <h3 id="voice-props-voice-pitch">The 'voice-pitch' property</h3>
17521745
"st" (semitones). A semitone is half of a tone (a half step) on the standard diatonic
17531746
scale. As such, a semitone doesn't correspond to a fixed frequency: the ratio between two
17541747
consecutive frequencies separated by exactly one semitone is the twelfth root of two
1755-
(approximately 1.05946). Computed absolute frequency values that are negative are clamped
1756-
to zero Hertz. </p>
1748+
(approximately 1.05946).</p>
17571749
</dd>
17581750
<dt>
17591751
<strong>&lt;percentage&gt;</strong>
@@ -1764,8 +1756,7 @@ <h3 id="voice-props-voice-pitch">The 'voice-pitch' property</h3>
17641756
Computed values are calculated by adding (or subtracting) the specified fraction of the
17651757
inherited value, to (from) the inherited value. For example, 50% (which is equivalent to
17661758
+50%) with a inherited value of 200Hz results in <code>200 + (200*0.5)</code> = 300Hz.
1767-
Conversely, -50% results in <code>200-(200*0.5)</code> = 100Hz. Computed absolute
1768-
frequency values that are negative are clamped to zero Hertz. </p>
1759+
Conversely, -50% results in <code>200-(200*0.5)</code> = 100Hz. </p>
17691760
</dd>
17701761
<dt><strong>x-low</strong>, <strong>low</strong>, <strong>medium</strong>,
17711762
<strong>high</strong>, <strong>x-high</strong></dt>
@@ -1774,6 +1765,14 @@ <h3 id="voice-props-voice-pitch">The 'voice-pitch' property</h3>
17741765
specific.</p>
17751766
</dd>
17761767
</dl>
1768+
1769+
<p> Computed absolute frequency values that are negative are clamped to zero Hertz.
1770+
Speech-capable user agents are likely to support a specific range of values rather than the
1771+
full range of possible calculated numerical values for frequencies. The actual values in user
1772+
agents may therefore be clamped to implementation-dependent minimum and maximum boundaries.
1773+
For example: although the 0Hz frequency can be legitimately calculated, it may be clamped to a
1774+
more meaningful value in the context of the speech synthesizer. </p>
1775+
17771776
<div class="example">
17781777
<p>Examples of property values:</p>
17791778
<pre>
@@ -1849,11 +1848,6 @@ <h3 id="voice-props-voice-range">The 'voice-range' property</h3>
18491848
example when variations in inflection are used to convey meaning and emphasis in speech.
18501849
Typically, a low range produces a flat, monotonic voice, whereas a high range produces an
18511850
animated voice. </p>
1852-
<p> Speech-capable user agents are likely to support a specific range of values rather than the
1853-
full range of possible calculated numerical values for frequencies. The actual values in user
1854-
agents may therefore be clamped to implementation-dependent minimum and maximum boundaries.
1855-
For example: although the 0Hz frequency can be legitimately calculated, it may be clamped to a
1856-
more meaningful value in the context of the speech synthesizer. </p>
18571851

18581852
<p class="note"> Note that the functionality provided by this property is related to the <a
18591853
href="http://www.w3.org/TR/speech-synthesis11/#edef_prosody"><code>range</code> attribute of
@@ -1868,15 +1862,14 @@ <h3 id="voice-props-voice-range">The 'voice-range' property</h3>
18681862
is used. Otherwise (when the 'absolute' keyword is not used), a negative value represents
18691863
an decrement, and a positive value represents an increment (relative to the inherited
18701864
value). For example, "2kHz" is a positive offset (strictly equivalent to "+2kHz"), and
1871-
"+2kHz absolute" is an absolute frequency (strictly equivalent to "2kHz absolute").
1872-
Computed absolute frequency values that are negative are clamped to zero Hertz. </p>
1865+
"+2kHz absolute" is an absolute frequency (strictly equivalent to "2kHz absolute"). </p>
18731866
</dd>
18741867
<dt>
18751868
<strong>absolute</strong>
18761869
</dt>
18771870
<dd>
18781871
<p> This keyword specifies that the provided frequency is expressed as an absolute, positive
1879-
value. When a negative value is provided, it is clamped to zero. </p>
1872+
value. If a negative frequency is specified, the computed frequency will be zero.</p>
18801873
</dd>
18811874
<dt>
18821875
<strong>&lt;semitones&gt;</strong>
@@ -1887,8 +1880,7 @@ <h3 id="voice-props-voice-range">The 'voice-range' property</h3>
18871880
"st" (semitones). A semitone is half of a tone (a half step) on the standard diatonic
18881881
scale. As such, a semitone doesn't correspond to a fixed frequency: the ratio between two
18891882
consecutive frequencies separated by exactly one semitone is the twelfth root of two
1890-
(approximately 1.05946). Computed absolute frequency values that are negative are clamped
1891-
to zero Hertz. </p>
1883+
(approximately 1.05946). </p>
18921884
</dd>
18931885
<dt>
18941886
<strong>&lt;percentage&gt;</strong>
@@ -1900,8 +1892,7 @@ <h3 id="voice-props-voice-range">The 'voice-range' property</h3>
19001892
inherited value, to (from) the inherited frequency value. For example, 50% (which is
19011893
equivalent to +50%) with a inherited value of 200Hz results in <code>200 +
19021894
(200*0.5)</code> = 300Hz. Conversely, -50% results in <code>200-(200*0.5)</code> =
1903-
100Hz. Computed absolute frequency values that are negative are clamped to zero Hertz.
1904-
</p>
1895+
100Hz. </p>
19051896
</dd>
19061897
<dt><strong>x-low</strong>, <strong>low</strong>, <strong>medium</strong>,
19071898
<strong>high</strong> and <strong>x-high</strong></dt>
@@ -1910,7 +1901,14 @@ <h3 id="voice-props-voice-range">The 'voice-range' property</h3>
19101901
language-dependent.</p>
19111902
</dd>
19121903
</dl>
1913-
1904+
1905+
<p> Computed absolute frequency values that are negative are clamped to zero Hertz.
1906+
Speech-capable user agents are likely to support a specific range of values rather than the
1907+
full range of possible calculated numerical values for frequencies. The actual values in user
1908+
agents may therefore be clamped to implementation-dependent minimum and maximum boundaries.
1909+
For example: although the 0Hz frequency can be legitimately calculated, it may be clamped to a
1910+
more meaningful value in the context of the speech synthesizer. </p>
1911+
19141912
<div class="example">
19151913
<p>Examples of inherited values:</p>
19161914
<pre>

0 commit comments

Comments
 (0)