(Merge)

Author: bert-github

.htaccess

@@ -12,7 +12,9 @@ RedirectPermanent /csswg/css4-mediaqueries http://dev.w3.org/csswg/mediaqueries4
 # Versioning System Switchover
 
 #XXX insert rules here
+Redirect /csswg/css3-text-decor http://dev.w3.org/csswg/css-text-decor-3
 
 # Unversioned URLs
 
 Redirect /csswg/css-counter-styles http://dev.w3.org/csswg/css-counter-styles-3
+Redirect /csswg/css-text-decor http://dev.w3.org/csswg/css-text-decor-3

css-counter-styles-3/Overview.html

@@ -125,6 +125,10 @@ <h2 id='counter-styles'>
 		<li>
 			a <dfn title='counter-range'>range</dfn>, 
 			which limits the values that a counter style handles
+
+		<li>
+			a <dfn title='counter-speak-as'>spoken form</dfn>,
+			which describes how to read out the counter style in a speech synthesizer
 
 		<li>
 			and a <dfn title='counter-fallback'>fallback style</dfn>, 
@@ -133,7 +137,7 @@ <h2 id='counter-styles'>
 	</ul>
 
 	<p>
-		When asked to <dfn title='generate-a-counter'>generate a counter representation</dfn> 
+		When asked to <dfn title='generate a counter|generate a counter representation'>generate a counter representation</dfn> 
 		using a particular counter style for a particular counter value, 
 		follow these steps:
 
@@ -919,6 +923,81 @@ <h3 id='counter-style-symbols'>
 		The <a href="http://dev.w3.org/csswg/css3-images/#default-object-size">default object size</a> of an image <i>counter symbol</i> is a 1em by 1em square.
 
 
+<h3 id='counter-style-speak-as'>
+Speech Synthesis: the 'speak-as' descriptor</h3>
+
+	<table class='descdef'>
+		<tr>
+			<th>Name:
+			<td><dfn id='descdef-speak-as'>speak-as</dfn>
+		<tr>
+			<th>Value:
+			<td>auto | numeric | alphabetic | bullet | &lt;counter-style-name>
+		<tr>
+			<th>Initial:
+			<td>auto
+	</table>
+
+	<p>
+		A counter style can be constructed with a meaning that is obvious visually,
+		but impossible to meaningfully represent via a speech synthesizer,
+		or possible but nonsensical when naively read out.
+		The 'speak-as' descriptor describes how to synthesize the spoken form of a counter formatted with the given counter style.
+		Values have the following meanings:
+
+	<dl>
+		<dt><dfn id='speak-as-auto'>''auto''</dfn>
+		<dd>
+			If the counter style's 'system' is ''alphabetic'', this value computes to ''alphabetic''.
+			If the 'system' is ''cyclic'', this value computes to ''bullet''.
+			Otherwise, this value computes to ''numeric''.
+
+		<dt><dfn id='speak-as-numeric'>''numeric''</dfn>
+		<dd>
+			The counter's value is spoken as a number in the document language.
+
+		<dt><dfn id='speak-as-alphabetic'>''alphabetic''</dfn>
+		<dd>
+			<i>Generate a counter representation</i> for the value as normal,
+			then spell it out letter-by-letter in the document language.
+			If the UA does not know how to pronounce the symbols,
+			it may handle it as ''numeric''.
+
+			<p>
+				For example, ''lower-greek'' in English would be read out as "alpha", "beta", "gamma", etc. 
+				Conversely, ''upper-latin'' in French would be read out as (in phonetic notation) /a/, /be/, /se/, etc.
+
+		<dt><dfn id='speak-as-symbolic'>''bullet''</dfn>
+		<dd>
+			The UA speaks a UA-defined phrase or audio cue that represents a list item being read out.
+
+		<dt><dfn id='speak-as-counter-style'><var>&lt;counter-style-name></var></dfn>
+		<dd>
+			The counter's value is instead spoken out in the specific style.
+			If the specified style does not exist,
+			this value is treated as ''auto''.
+	</dl>
+
+	<div class='example'>
+		<p>
+			The ability to defer pronunciation to another counter style can help when the symbols being used aren't actually letters.
+			For example, here's a possible definition of a ''circled-lower-latin'' counter-style, using some special unicode characters:
+
+		<pre class='stylesheet'>
+@counter-style <dfn>circled-lower-latin</dfn> {
+  system: alphabetic;
+  speak-as: lower-latin;
+  symbols: ⓐ ⓑ ⓒ ⓓ ⓔ ⓕ ⓖ ⓗ ⓘ ⓙ ⓚ ⓛ ⓜ ⓝ ⓞ ⓟ ⓠ ⓡ ⓢ ⓣ ⓤ ⓥ ⓦ ⓧ ⓨ ⓩ;
+  suffix: '';
+}</pre>
+
+		<p>
+			Setting its 'system' to ''alphabetic'' would normally make the UA try to read out the names of the characters,
+			but in this case that might be something like "Circled Letter A",
+			which is unlikely to make sense.
+			Instead, explicitly setting 'speak-as' to ''lower-latin'' ensures that they get read out as their corresponding latin letters, as intended.
+	</div>
+
 <!-- ====================================================================== -->
 
 <h2 id='symbols-function'>
@@ -1296,6 +1375,9 @@ <h2 id='complex-predefined-counters'>
 		For example, an author can reference one of these styles in an ''override'' system, 
 		reusing the algorithm but swapping out some of the other descriptors.
 
+	<p>
+		All of the counter styles defined in this section have a <i title='counter-speak-as'>spoken form</i> of ''numeric''.
+
 
 <h3 id='complex-cjk'>
 Longhand East Asian Counter Styles: ''japanese-informal'', ''japanese-formal'', ''korean-hangul-formal'', ''korean-hanja-informal'', ''korean-hanja-formal'', ''simp-chinese-informal'', ''simp-chinese-formal'', ''trad-chinese-informal'', ''trad-chinese-formal''</h3>