[css-counter-styles-3] Make all algorithms capable of rendering negatives. Describe how to handle the 'width' descriptor. Make all the descriptors use <symbol> rather than <string>.

Author: tabatkins

css-counter-styles-3/Overview.html

@@ -409,13 +409,28 @@ <h2 id=counter-styles><span class=secno>2. </span> Counter Styles</h2>
   <ol>
    <li> If the counter value is outside the <a href="#range"><i
     title=counter-range>range</i></a> of the counter style, exit this
-    algorithm and instead <i title=generate-a-counter>generate a counter
-    representation</i> using the counter style's fallback style and the same
-    counter value.
+    algorithm and instead <a
+    href="#generate-a-counter-representation"><i>generate a counter
+    representation</i></a> using the counter style's fallback style and the
+    same counter value.
 
    <li> Using the counter value and the <a href="#algorithm"><i
     title=counter-algorithm>counter algorithm</i></a> for the counter style,
-    generate an initial representation for the counter value.
+    generate an initial representation for the counter value. If the counter
+    value is negative, instead generate an initial representation using the
+    absolute value of it.
+
+   <li> If the representation uses less symbols than specified in the counter
+    style's ‘<a href="#descdef-width"><code
+    class=property>width</code></a>’ descriptor, prepend symbols to the
+    representation as specified in the ‘<a href="#descdef-width"><code
+    class=property>width</code></a>’ descriptor.
+
+   <li> If the counter value is negative, wrap the representation in the
+    counter style's <a href="#negative-sign"><i
+    title=counter-negative>negative sign</i></a> as specified in the ‘<a
+    href="#descdef-negative"><code class=property>negative</code></a>’
+    descriptor.
 
    <li> Return the representation.
   </ol>
@@ -863,19 +878,14 @@ <h4 id=numeric-system><span class=secno>3.1.5. </span> Positional Numerals:
 
   <p> Let <var>N</var> be the length of the list of <i>counter symbols</i>,
    <var>value</var> initially be the counter value, <var>S</var> initially be
-   the empty string, <a href="#descdef-negative"><var>negative</var></a> be a
-   boolean flag that is initially false, and <var>symbol(n)</var> be the nth
-   <a href="#counter-symbol"><i>counter symbol</i></a> in the list of
-   <i>counter symbols</i> (0-indexed).
+   the empty string, and <var>symbol(n)</var> be the nth <a
+   href="#counter-symbol"><i>counter symbol</i></a> in the list of <i>counter
+   symbols</i> (0-indexed).
 
   <ol>
    <li>If <var>value</var> is 0, append <var>symbol(0)</var> to <var>S</var>
     and return <var>S</var>.
 
-   <li>If <var>value</var> is negative, run the next step of this algorithm
-    with <var>value</var> being the absolute value of <var>value</var>
-    instead.
-
    <li>While <var>value</var> is not equal to 0:
     <ol>
      <li>Prepend <var>symbol( <var>value</var> mod <var>N</var> )</var> to
@@ -885,11 +895,6 @@ <h4 id=numeric-system><span class=secno>3.1.5. </span> Positional Numerals:
       )</code>.
     </ol>
 
-   <li>If <var>value</var> was originally negative, wrap <var>S</var> in the
-    counter style's <a href="#negative-sign"><i
-    title=counter-negative>negative sign</i></a>, as specified in the section
-    for the <a href="#counter-style-negative">negative descriptor</a>.
-
    <li>Return <var>S</var>.
   </ol>
 
@@ -950,10 +955,6 @@ <h4 id=additive-system><span class=secno>3.1.6. </span> Accumulating
     append that tuple's <a href="#counter-symbol"><i>counter symbol</i></a>
     to S and return S.
 
-   <li>If <var>value</var> is negative, run the next step of this algorithm
-    with <var>value</var> being the absolute value of <var>value</var>
-    instead.
-
    <li>While <var>value</var> is greater than 0 and there are elements left
     in the <var>symbol list</var>:
     <ol>
@@ -973,11 +974,6 @@ <h4 id=additive-system><span class=secno>3.1.6. </span> Accumulating
       tuple</i></a> was appended to <var>S</var> in the previous step. </var>
     </ol>
 
-   <li>If <var>value</var> was originally negative, wrap <var>S</var> in the
-    counter style's <a href="#negative-sign"><i
-    title=counter-negative>negative sign</i></a>, as specified in the section
-    for the <a href="#counter-style-negative">negative descriptor</a>.
-
    <li>If the loop ended because <var>value</var> is 0, return S. Otherwise,
     the given counter value cannot be represented by this counter style, and
     must instead be represented by the fallback counter style.
@@ -1026,7 +1022,8 @@ <h3 id=counter-style-negative><span class=secno>3.2. </span> Formatting
     <tr>
      <th>Value:
 
-     <td>&lt;string> &lt;string>?
+     <td><a href="#ltsymbol"><var>&lt;symbol></var></a> <a
+      href="#ltsymbol"><var>&lt;symbol></var></a>?
 
     <tr>
      <th>Initial:
@@ -1036,11 +1033,11 @@ <h3 id=counter-style-negative><span class=secno>3.2. </span> Formatting
 
   <p>The ‘<a href="#descdef-negative"><code
    class=property>negative</code></a>’ descriptor defines how to alter the
-   representation when the counter value is negative. Not all counter systems
-   can render negative numbers.
+   representation when the counter value is negative.
 
-  <p>The first string in the value is prepended to the representation when
-   the counter value is negative. The second string, if specified, is
+  <p>The first <a href="#ltsymbol"><var>&lt;symbol></var></a> in the value is
+   prepended to the representation when the counter value is negative. The
+   second <a href="#ltsymbol"><var>&lt;symbol></var></a>, if specified, is
    appended to the representation when the counter value is negative.
 
   <div class=example>
@@ -1063,7 +1060,7 @@ <h3 id=counter-style-prefix><span class=secno>3.3. </span> Symbols before
     <tr>
      <th>Value:
 
-     <td>&lt;string>
+     <td><a href="#ltsymbol"><var>&lt;symbol></var></a>
 
     <tr>
      <th>Initial:
@@ -1072,9 +1069,10 @@ <h3 id=counter-style-prefix><span class=secno>3.3. </span> Symbols before
   </table>
 
   <p>The ‘<a href="#descdef-prefix"><code
-   class=property>prefix</code></a>’ descripter specifies a string that is
-   prepended to the marker representation. Prefixes are only added by the
-   algorithm for constructing the default contents of the ‘<code
+   class=property>prefix</code></a>’ descripter specifies a <a
+   href="#ltsymbol"><var>&lt;symbol></var></a> that is prepended to the
+   marker representation. Prefixes are only added by the algorithm for
+   constructing the default contents of the ‘<code
    class=css>::marker</code>’ pseudo-element; the prefix is not added
    automatically when the counter() or counters() functions are used.
    Prefixes come before any negative sign.
@@ -1093,7 +1091,7 @@ <h3 id=counter-style-suffix><span class=secno>3.4. </span> Symbols after
     <tr>
      <th>Value:
 
-     <td>&lt;string>
+     <td><a href="#ltsymbol"><var>&lt;symbol></var></a>
 
     <tr>
      <th>Initial:
@@ -1102,12 +1100,13 @@ <h3 id=counter-style-suffix><span class=secno>3.4. </span> Symbols after
   </table>
 
   <p>The ‘<a href="#descdef-suffix"><code
-   class=property>suffix</code></a>’ descripter specifies a string that is
-   appended to the marker representation. Suffixes are only added by the
-   algorithm for constructing the default contents of the ‘<code
-   class=css>::marker</code>’ pseudo-element; the suffix is not added
-   automatically when the counter() or counters() functions are used.
-   Suffixes are added to the representation after negative signs.
+   class=property>suffix</code></a>’ descripter specifies a <a
+   href="#ltsymbol"><var>&lt;symbol></var></a> that is appended to the marker
+   representation. Suffixes are only added by the algorithm for constructing
+   the default contents of the ‘<code class=css>::marker</code>’
+   pseudo-element; the suffix is not added automatically when the counter()
+   or counters() functions are used. Suffixes are added to the representation
+   after negative signs.
 
   <h3 id=counter-style-range><span class=secno>3.5. </span> Limiting the
    counter scope: the ‘<a href="#descdef-range"><code
@@ -1202,7 +1201,8 @@ <h3 id=counter-style-width><span class=secno>3.6. </span> Constant-width
   <p> The ‘<a href="#descdef-width"><code
    class=property>width</code></a>’ descriptor allows an author to specify
    a "fixed-width" counter style, where representations shorter than the
-   width are padded with a particular character.
+   width are padded with a particular character. Representations larger than
+   the specified width are constructed as normal.
 
   <dl>
    <dt>auto
@@ -1216,14 +1216,14 @@ <h3 id=counter-style-width><span class=secno>3.6. </span> Constant-width
     counter representations must reach. If a counter representation would be
     generated using less <a href="#ltsymbol"><var>&lt;symbol></var></a>s than
     the specified <var>&lt;integer></var> (before adding
-    prefixes/suffixes/negatives), pad the front of the representation with
-    copies of the specified <a href="#ltsymbol"><var>&lt;symbol></var></a>
-    until the number of symbols reaches the specified width.
-    <p> If the counter value is negative, reduce the width by one or two,
-     depending on whether the second <var>&lt;string></var> value is omitted
-     or provided, respectively, in the ‘<a href="#descdef-negative"><code
-     class=property>negative</code></a>’ descriptor for the given counter
-     style.
+    prefixes/suffixes/negatives), prepend copies of the specified <a
+    href="#ltsymbol"><var>&lt;symbol></var></a> to the representation until
+    the number of symbols reaches the specified width.
+    <p> If the counter value is negative, reduce the width by one or two when
+     determining how many copies to prepend, depending on whether the ‘<a
+     href="#descdef-negative"><code class=property>negative</code></a>’
+     descriptor's value is one or two <a
+     href="#ltsymbol"><var>&lt;symbol></var></a>s.
   </dl>
 
   <div class=example> The most common example of "fixed-width" numbering is
@@ -3683,14 +3683,14 @@ <h2 class=no-num id=descriptor-index>Descriptor index</h2>
     <tr>
      <th><a class=property href="#descdef-negative">negative</a>
 
-     <td>&lt;string> &lt;string>?
+     <td>&lt;symbol> &lt;symbol>?
 
      <td>"\2D" ("-" hyphen-minus)
 
     <tr>
      <th><a class=property href="#descdef-prefix">prefix</a>
 
-     <td>&lt;string>
+     <td>&lt;symbol>
 
      <td>"" (the empty string)
 
@@ -3711,7 +3711,7 @@ <h2 class=no-num id=descriptor-index>Descriptor index</h2>
     <tr>
      <th><a class=property href="#descdef-suffix">suffix</a>
 
-     <td>&lt;string>
+     <td>&lt;symbol>
 
      <td>"\2E" ("." full stop)
 

css-counter-styles-3/Overview.src.html

@@ -145,12 +145,23 @@ <h2 id='counter-styles'>
 	<ol>
 		<li>
 			If the counter value is outside the <i title='counter-range'>range</i> of the counter style, 
-			exit this algorithm and instead <i title='generate-a-counter'>generate a counter representation</i> 
+			exit this algorithm and instead <i>generate a counter representation</i> 
 			using the counter style's fallback style and the same counter value.
 
 		<li>
 			Using the counter value and the <i title='counter-algorithm'>counter algorithm</i> for the counter style, 
 			generate an initial representation for the counter value.
+			If the counter value is negative,
+			instead generate an initial representation using the absolute value of it.
+
+		<li>
+			If the representation uses less symbols than specified in the counter style's 'width' descriptor,
+			prepend symbols to the representation as specified in the 'width' descriptor.
+
+		<li>
+			If the counter value is negative,
+			wrap the representation in the counter style's <i title='counter-negative'>negative sign</i>
+			as specified in the 'negative' descriptor.
 
 		<li>
 			Return the representation.
@@ -557,15 +568,12 @@ <h4 id="numeric-system">
 		Let <var>N</var> be the length of the list of <i>counter symbols</i>, 
 		<var>value</var> initially be the counter value, 
 		<var>S</var> initially be the empty string, 
-		<var>negative</var> be a boolean flag that is initially false, 
 		and <var>symbol(n)</var> be the nth <i>counter symbol</i> in the list of <i>counter symbols</i> (0-indexed).
 
 	<ol>
 		<li>If <var>value</var> is 0, append <var>symbol(0)</var> to 
 		<var>S</var> and return <var>S</var>.
 
-		<li>If <var>value</var> is negative, run the next step of this algorithm with <var>value</var> being the absolute value of <var>value</var> instead.
-
 		<li>While <var>value</var> is not equal to 0:
 
 			<ol>
@@ -574,9 +582,6 @@ <h4 id="numeric-system">
 
 				<li>Set <var>value</var> to <code>floor( <var>value</var> / <var>N</var> )</code>.
 			</ol>
-		
-
-		<li>If <var>value</var> was originally negative, wrap <var>S</var> in the counter style's <i title='counter-negative'>negative sign</i>, as specified in the section for the <a href='#counter-style-negative'>negative descriptor</a>.
 
 		<li>Return <var>S</var>.
 	</ol>
@@ -635,8 +640,6 @@ <h4 id="additive-system">
 	<ol>
 		<li>If <var>value</var> is initially 0, and there is an <i>additive tuple</i> with a weight of 0, append that tuple's <i>counter symbol</i> to S and return S.
 
-		<li>If <var>value</var> is negative, run the next step of this algorithm with <var>value</var> being the absolute value of <var>value</var> instead.
-
 		<li>While <var>value</var> is greater than 0 and there are elements left in the <var>symbol list</var>:
 
 			<ol>
@@ -651,9 +654,6 @@ <h4 id="additive-system">
 				by the number of times the <i>current tuple</i> was appended to <var>S</var>
 				in the previous step.
 			</ol>
-		
-
-		<li>If <var>value</var> was originally negative, wrap <var>S</var> in the counter style's <i title='counter-negative'>negative sign</i>, as specified in the section for the <a href='#counter-style-negative'>negative descriptor</a>.
 
 		<li>If the loop ended because <var>value</var> is 0, return S.  Otherwise, the given counter value cannot be represented by this counter style, and must instead be represented by the fallback counter style.
 	</ol>
@@ -693,18 +693,17 @@ <h3 id='counter-style-negative'>
 			<td><dfn id="descdef-negative">negative</dfn>
 		<tr>
 			<th>Value:
-			<td>&lt;string> &lt;string>?
+			<td><var>&lt;symbol></var> <var>&lt;symbol></var>?
 		<tr>
 			<th>Initial:
 			<td>"\2D" ("-" hyphen-minus)
 	</table>
 
 	<p>The 'negative' descriptor defines how to alter the representation when
-	the counter value is negative.  Not all counter systems can render negative
-	numbers.
+	the counter value is negative.
 
-	<p>The first string in the value is prepended to the representation when the
-	counter value is negative.  The second string, if specified, is appended
+	<p>The first <var>&lt;symbol></var> in the value is prepended to the representation when the
+	counter value is negative.  The second <var>&lt;symbol></var>, if specified, is appended
 	to the representation when the counter value is negative.
 
 	<div class='example'>
@@ -723,13 +722,13 @@ <h3 id='counter-style-prefix'>
 			<td><dfn id="descdef-prefix">prefix</dfn>
 		<tr>
 			<th>Value:
-			<td>&lt;string>
+			<td><var>&lt;symbol></var>
 		<tr>
 			<th>Initial:
 			<td>"" (the empty string)
 	</table>
 
-	<p>The 'prefix' descripter specifies a string that is prepended to the 
+	<p>The 'prefix' descripter specifies a <var>&lt;symbol></var> that is prepended to the 
 	marker representation.  Prefixes are only added by the algorithm for constructing
 	the default contents of the ''::marker'' pseudo-element; the prefix is not 
 	added automatically when the counter() or counters() functions are used.  
@@ -745,13 +744,13 @@ <h3 id='counter-style-suffix'>
 			<td><dfn id="descdef-suffix">suffix</dfn>
 		<tr>
 			<th>Value:
-			<td>&lt;string>
+			<td><var>&lt;symbol></var>
 		<tr>
 			<th>Initial:
 			<td>"\2E" ("." full stop)
 	</table>
 
-	<p>The 'suffix' descripter specifies a string that is appended to the 
+	<p>The 'suffix' descripter specifies a <var>&lt;symbol></var> that is appended to the 
 	marker representation.  Suffixes are only added by the algorithm for constructing
 	the default contents of the ''::marker'' pseudo-element; the suffix is not 
 	added automatically when the counter() or counters() functions are used.  
@@ -806,6 +805,7 @@ <h3 id='counter-style-width'>
 	<p>
 		The 'width' descriptor allows an author to specify a "fixed-width" counter style,
 		where representations shorter than the width are padded with a particular character.
+		Representations larger than the specified width are constructed as normal.
 
 	<dl>
 		<dt>auto
@@ -817,14 +817,13 @@ <h3 id='counter-style-width'>
 			The <var>&lt;integer></var> specifies a minimum width that all counter representations must reach.
 			If a counter representation would be generated using less <var>&lt;symbol></var>s than the specified <var>&lt;integer></var>
 			(before adding prefixes/suffixes/negatives),
-			pad the front of the representation with copies of the specified <var>&lt;symbol></var>
+			prepend copies of the specified <var>&lt;symbol></var> to the representation
 			until the number of symbols reaches the specified width.
 
 			<p>
 				If the counter value is negative,
-				reduce the width by one or two,
-				depending on whether the second <var>&lt;string></var> value is omitted or provided, respectively,
-				in the 'negative' descriptor for the given counter style.
+				reduce the width by one or two when determining how many copies to prepend,
+				depending on whether the 'negative' descriptor's value is one or two <var>&lt;symbol></var>s.
 	</dl>
 
 	<div class='example'>