Reworked the CJK section again with feedback from fantasai and others.

tabatkins · tabatkins · commit 20a3d9ca02f2 · 2011-04-23T01:18:03.000Z
diff --git a/css3-lists/Overview.html b/css3-lists/Overview.html
@@ -24,12 +24,12 @@
 
    <h1>CSS Lists and Counters Module Level 3</h1>
 
-   <h2 class="no-num no-toc" id=longstatus-date>Editor's Draft 22 April 2011</h2>
+   <h2 class="no-num no-toc" id=longstatus-date>Editor's Draft 23 April 2011</h2>
 
    <dl>
     <dt>This version:
 
-    <dd><!-- <a href="http://www.w3.org/TR/2011/WD-css3-lists-20110422">http://www.w3.org/TR/2011/WD-css3-lists-20110422</a></dd> -->
+    <dd><!-- <a href="http://www.w3.org/TR/2011/WD-css3-lists-20110423">http://www.w3.org/TR/2011/WD-css3-lists-20110423</a></dd> -->
      <a
      href="http://dev.w3.org/csswg/css3-lists/">http://dev.w3.org/csswg/css3-lists/</a>
 
@@ -171,7 +171,7 @@ <h2 class="no-num no-toc" id=contents> Table of contents</h2>
         style</a>
 
        <li><a href="#cjk-counter-styles"><span class=secno>4.3.2. </span> The
-        CJK "spoken-out" counter styles</a>
+        CJK longhand counter styles</a>
       </ul>
     </ul>
 
@@ -707,24 +707,73 @@ <h4 id=ethiopic-numeric><span class=secno>4.3.1. </span> The &lsquo;<code
     U+137B <!-- odd --> U+137A U+136A. <!-- 90 2 --></p>
   </div>
 
-  <h4 id=cjk-counter-styles><span class=secno>4.3.2. </span> The CJK
-   "spoken-out" counter styles</h4>
-
-  <p>Chinese, Japanese, and Korean all share almost identical "spoken-out"
-   counter styles, which are roughly similar to using "one, two, three..." in
-   English. The Chinese and Japanese styles are defined for all numbers
-   between -10<sup>16</sup> and 10<sup>16</sup>, exclusive; the Korean styles
-   are defined for all non-negative numbers less than 10<sup>16</sup>. All of
-   the styles are defined by almost identical algorithms (specified as a
-   single algorithm here, with the differences called out when relevant), but
-   use different sets of characters. The list following the algorithm gives
-   the name of each counter style using this algorithm, and the individual
-   character sets used by each style.
-
-  <p>For legacy reasons, the counter style &lsquo;<code
-   class=css>cjk-ideographic</code>&rsquo; must be treated as an alias for
-   &lsquo;<a href="#trad-chinese-informal"><code
-   class=css>trad-chinese-informal</code></a>&rsquo;.
+  <h4 id=cjk-counter-styles><span class=secno>4.3.2. </span> The CJK longhand
+   counter styles</h4>
+
+  <p>Chinese, Japanese, and Korean have longhand counter styles, which have a
+   structure similar to "one hundred thirteen thousand and twenty-three" in
+   English. Each has both formal and informal variants. <span class=note> The
+   formal styles are typically used in financial and legal documents, as
+   their characters are more difficult to alter.</span>
+
+  <p>The following counter styles are defined in this section:
+
+  <dl>
+   <dt>simp-chinese-informal
+
+   <dd>The simplified Chinese informal style.
+
+   <dt>simp-chinese-formal
+
+   <dd>The simplified Chinese formal style
+
+   <dt>trad-chinese-informal
+
+   <dd>The traditional Chinese informal style
+
+   <dt>trad-chinese-formal
+
+   <dd>The traditional Chinese formal style
+
+   <dt>japanese-informal
+
+   <dd>The Japanese informal style
+
+   <dt>japanese-formal
+
+   <dd>The Japanese formal style
+
+   <dt>korean-hangul-formal
+
+   <dd>The Korean hangul-characters formal style
+
+   <dt>korean-hanja-informal
+
+   <dd>The Korean hanja-characters informal style
+
+   <dt>korean-hanja-formal
+
+   <dd>The Korean hanja-characters formal style
+
+   <dt>cjk-ideographic
+
+   <dd>For legacy reasons, this counter-style must be treated as an alias for
+    &lsquo;<a href="#trad-chinese-informal"><code
+    class=css>trad-chinese-informal</code></a>&rsquo;.
+  </dl>
+
+  <p class=issue>Add an example to each of the above types.
+
+  <p>The Chinese and Japanese styles are defined for all numbers between
+   -10<sup>16</sup> and 10<sup>16</sup>, exclusive; the Korean styles are
+   defined for all non-negative numbers less than 10<sup>16</sup>. For
+   numbers outside this range, the &lsquo;<code
+   class=css>cjk-decimal</code>&rsquo; style is used. All of the styles are
+   defined by almost identical algorithms (specified as a single algorithm
+   here, with the differences called out when relevant), but use different
+   sets of characters. The list following the algorithm gives the name of
+   each counter style using this algorithm, and the individual character sets
+   used by each style.
 
   <ol>
    <li>If the counter value is 0, the representation is the character for 0
@@ -764,23 +813,12 @@ <h4 id=cjk-counter-styles><span class=secno>4.3.2. </span> The CJK
     <ul>
      <li>For the Japanese and Korean styles, drop all zero digits.
 
-     <li>For the Chinese informal styles, drop all groups with the value 0.
-
-     <li>For all Chinese styles, drop any trailing zeros for all non-zero
+     <li>For the Chinese styles, drop any trailing zeros for all non-zero
       groups and collapse (across groups) each remaining consecutive group of
       zeros into a single zero digit.
     </ul>
 
-   <li>Recombine groups:
-    <ul>
-     <li>For the Chinese and Japanese styles, concatenate the groups back
-      into a single string, least significant group first (on the right).
-
-     <li>For the Korean styles, concatenate the groups back into a single
-      string, least significant group first (on the right), with a space
-      (&lsquo;<code class=css> </code>&rsquo; U+0020) inserted between each
-      group.
-    </ul>
+   <li>For the Korean styles, insert a space (" " U+0020) between each group.
 
    <li>If the <var>negative flag</var> was set to true earlier in the
     algorithm, prepend the appropriate negative sign for the given counter
@@ -895,7 +933,7 @@ <h4 id=cjk-counter-styles><span class=secno>4.3.2. </span> The CJK
       <tr>
        <td>Negative Sign
 
-       <td>負 U+8D1F
+       <td>负 U+8D1F
     </table>
 
    <dt><dfn id=simp-chinese-formal>simp-chinese-formal</dfn>
@@ -1009,7 +1047,7 @@ <h4 id=cjk-counter-styles><span class=secno>4.3.2. </span> The CJK
       <tr>
        <td>Digit 0
 
-       <td>〇 U+3007
+       <td>零 U+96F6
 
       <tr>
        <td>Digit 1
@@ -1089,7 +1127,7 @@ <h4 id=cjk-counter-styles><span class=secno>4.3.2. </span> The CJK
       <tr>
        <td>Negative Sign
 
-       <td><span class=issue>Fill this in</span>
+       <td>負 U+8CA0
     </table>
 
    <dt><dfn id=trad-chinese-formal>trad-chinese-formal</dfn>
@@ -1186,7 +1224,7 @@ <h4 id=cjk-counter-styles><span class=secno>4.3.2. </span> The CJK
       <tr>
        <td>Negative Sign
 
-       <td><span class=issue>Fill this in</span>
+       <td>負 U+8CA0
     </table>
 
    <dt><dfn id=japanese-informal>japanese-informal</dfn>
diff --git a/css3-lists/Overview.src.html b/css3-lists/Overview.src.html
@@ -417,22 +417,63 @@ <h4 id='ethiopic-numeric'>
 	</div>
 
 <h4 id='cjk-counter-styles'>
-The CJK "spoken-out" counter styles</h4>
+The CJK longhand counter styles</h4>
 
-	<p>Chinese, Japanese, and Korean all share almost identical "spoken-out"
-	counter styles, which are roughly similar to using "one, two, three..." in
-	English. The Chinese and Japanese styles are defined for all numbers between 
+	<p>Chinese, Japanese, and Korean have longhand counter styles, which have 
+	a structure similar to "one hundred thirteen thousand and twenty-three" in 
+	English.  Each has both formal and informal variants. <span class='note'>
+	The formal styles are typically used in financial and legal documents, as 
+	their characters are more difficult to alter.</span></p>
+
+	<p>The following counter styles are defined in this section:</p>
+
+	<dl>
+		<dt>simp-chinese-informal</dt>
+		<dd>The simplified Chinese informal style.</dd>
+
+		<dt>simp-chinese-formal</dt>
+		<dd>The simplified Chinese formal style</dd>
+
+		<dt>trad-chinese-informal</dt>
+		<dd>The traditional Chinese informal style</dd>
+
+		<dt>trad-chinese-formal</dt>
+		<dd>The traditional Chinese formal style</dd>
+
+		<dt>japanese-informal</dt>
+		<dd>The Japanese informal style</dd>
+
+		<dt>japanese-formal</dt>
+		<dd>The Japanese formal style</dd>
+
+		<dt>korean-hangul-formal</dt>
+		<dd>The Korean hangul-characters formal style</dd>
+
+		<dt>korean-hanja-informal</dt>
+		<dd>The Korean hanja-characters informal style</dd>
+
+		<dt>korean-hanja-formal</dt>
+		<dd>The Korean hanja-characters formal style</dd>
+
+		<dt>cjk-ideographic</dt>
+		<dd>For legacy reasons, this counter-style must be treated as an alias
+		for ''trad-chinese-informal''.</dd>
+	</dl>
+
+	<p class='issue'>Add an example to each of the above types.</p>
+
+
+
+	<p>The Chinese and Japanese styles are defined for all numbers between 
 	-10<sup>16</sup> and 10<sup>16</sup>, exclusive; the Korean styles are 
-	defined for all non-negative numbers less than 10<sup>16</sup>.  All of the
+	defined for all non-negative numbers less than 10<sup>16</sup>.  For numbers
+	outside this range, the ''cjk-decimal'' style is used.  All of the
 	styles are defined by almost identical algorithms (specified as a single
 	algorithm here, with the differences called out when relevant), but use 
 	different sets of characters.  The list following the algorithm gives the
 	name of each counter style using this algorithm, and the individual character
 	sets used by each style.</p>
 
-	<p>For legacy reasons, the counter style ''cjk-ideographic'' must be treated
-	as an alias for ''trad-chinese-informal''.</p>
-
 	<ol>
 		<li>If the counter value is 0, the representation is the character for 0
 		specified for the given counter style.  Skip the rest of this algorithm.</li>
@@ -473,26 +514,13 @@ <h4 id='cjk-counter-styles'>
 			<ul>
 				<li>For the Japanese and Korean styles, drop all zero digits.</li>
 
-				<li>For the Chinese informal styles, drop all groups with the
-				value 0.</li>
-
-				<li>For all Chinese styles, drop any trailing zeros for all
+				<li>For the Chinese styles, drop any trailing zeros for all
 				non-zero groups and collapse (across groups) each remaining
 				consecutive group of zeros into a single zero digit.</li>
 			</ul>
 		</li>
 
-		<li>Recombine groups:
-			<ul>
-				<li>For the Chinese and Japanese styles, concatenate the groups
-				back into a single string, least significant group first (on the
-				right).</li>
-
-				<li>For the Korean styles, concatenate the groups back into a 
-				single string, least significant group first (on the right), with
-				a space (' ' U+0020) inserted between each group.</li>
-			</ul>
-		</li>
+		<li>For the Korean styles, insert a space (" " U+0020) between each group.</li>
 
 		<li>If the <var>negative flag</var> was set to true earlier in the 
 		algorithm, prepend the appropriate negative sign for the given counter
@@ -571,7 +599,7 @@ <h4 id='cjk-counter-styles'>
 						<td>万亿 U+4E07 U+4EBF
 					<tr>
 						<td>Negative Sign
-						<td>負 U+8D1F
+						<td>负 U+8D1F
 				</tbody>
 			</table>
 		</dd>
@@ -651,7 +679,7 @@ <h4 id='cjk-counter-styles'>
 				<tbody>
 					<tr>
 						<td>Digit 0  
-						<td>〇 U+3007
+						<td>零  U+96F6
 					<tr>
 						<td>Digit 1  
 						<td>一 U+4E00
@@ -699,7 +727,7 @@ <h4 id='cjk-counter-styles'>
 						<td>兆 U+5146
 					<tr>
 						<td>Negative Sign
-						<td><span class=issue>Fill this in</span>
+						<td>負 U+8CA0
 		</dd>
 
 		<dt><dfn>trad-chinese-formal</dfn></dt>
@@ -761,7 +789,7 @@ <h4 id='cjk-counter-styles'>
 						<td>兆  U+5146
 					<tr>
 						<td>Negative Sign
-						<td><span class=issue>Fill this in</span>
+						<td>負 U+8CA0
 				</tbody>
 			</table>
 		</dd>
