[css-counter-styles] Fixed up 'width', per SS's emails.

Author: tabatkins

css-counter-styles/Overview.html

@@ -13,7 +13,7 @@
 </a></p>
   <h1 class="p-name no-ref" id="title">CSS Counter Styles Level 3</h1>
   <h2 class="no-num no-toc no-ref" id="subtitle">Editor's Draft,
-    <span class="dt-updated"><span class="value-title" title="20130403">3 April 2013</span></span></h2>
+    <span class="dt-updated"><span class="value-title" title="20130409">9 April 2013</span></span></h2>
   <div data-fill-with="spec-metadata"><dl><dt>This version:</dt><dd><a href="http://dev.w3.org/csswg/css-counter-styles/" class="u-url">http://dev.w3.org/csswg/css-counter-styles/</a></dd><dt>Latest version:</dt><dd><a href="http://w3.org/TR/css-counter-styles-3/">http://w3.org/TR/css-counter-styles-3/</a></dd><dt>Editor's Draft:</dt><dd><a href="http://dev.w3.org/csswg/css-counter-styles/">http://dev.w3.org/csswg/css-counter-styles/</a></dd><dt>Previous Versions:</dt><dd><a href="http://www.w3.org/TR/2012/WD-css-counter-styles-3-20121009/" rel="previous">http://www.w3.org/TR/2012/WD-css-counter-styles-3-20121009/</a>
 </dd><dt>Feedback:</dt>
     <dd><a href="mailto:www-style@w3.org?subject=%5Bcss-counter-styles%5D%20feedback">www-style@w3.org</a> 
@@ -117,6 +117,7 @@ <h2 id="contents" class="no-num no-toc no-ref">Table of contents</h2>
 Index</a></li><li><a href="#property-index">
 Property index</a></li></ul></div>
 
+
 <style>
 pre.stylesheet { white-space: pre-wrap; }
 </style>
@@ -798,21 +799,20 @@ <h4 id="additive-system" data-level="3.1.6"><span class="secno">3.1.6 </span>
 	Representations larger than the specified width are constructed as normal.
 
 	</p><dl>
-		<dt>auto
-		</dt><dd>
-			This descriptor has no effect on counter representations.
-
-		</dd><dt><var>&lt;integer&gt;</var> &amp;&amp; <var>&lt;symbol&gt;</var>
+		<dt><a data-autolink="link" class="production"><var>&lt;integer&gt;</var></a> &amp;&amp; <a data-autolink="link" class="production" href="#symbol-production"><var>&lt;symbol&gt;</var></a>
 		</dt><dd>
-			The <var>&lt;integer&gt;</var> specifies a minimum width that all counter representations must reach.
-			If a counter representation would be generated using less <var>&lt;symbol&gt;</var>s than the specified <var>&lt;integer&gt;</var>
+			The <a data-autolink="link" class="production"><var>&lt;integer&gt;</var></a> specifies a minimum width that all counter representations must reach.
+			If a counter representation would be generated using less <a data-autolink="link" class="production" href="#symbol-production"><var>&lt;symbol&gt;</var></a>s than the specified <a data-autolink="link" class="production"><var>&lt;integer&gt;</var></a>
 			(before adding prefixes/suffixes/negatives),
-			prepend copies of the specified <var>&lt;symbol&gt;</var> to the representation
+			prepend copies of the specified <a data-autolink="link" class="production" href="#symbol-production"><var>&lt;symbol&gt;</var></a> to the representation
 			until the number of symbols reaches the specified width.
 
-<p>			If the counter value is negative
+<p>			The <a data-autolink="link" class="production"><var>&lt;integer&gt;</var></a> must be non-negative.
+			A negative value is a syntax error.
+
+</p><p>			If the counter value is negative
 			and the counter style is <a data-autolink="link" href="#negative-capable">negative-capable</a>,
-			reduce the width by one or two when determining how many copies to prepend,
+			treat the minimum width as being one or two smaller when determining how many copies to prepend,
 			depending on whether the <a data-autolink="property" class="property" title="negative" href="#negative">negative</a> descriptor's value is one or two <var>&lt;symbol&gt;</var>s.
 	</p></dd></dl>
 
@@ -826,11 +826,20 @@ <h4 id="additive-system" data-level="3.1.6"><span class="secno">3.1.6 </span>
 			1 to be represented as "001", 
 			20 to be represented as "020",
 			300 to be represented as "300",
-			and -4 to be represented as "-04".
+			4000 to be represented as "4000",
+			and -5 to be represented as "-05".
 	</p></div>
 
+<p class="note">	Note: The <a data-autolink="property" class="property" title="width" href="#width">width</a> descriptor counts the number of <em><a data-autolink="link" class="production" href="#symbol-production"><var>&lt;symbol&gt;</var></a>s</em> used to construct the representation,
+	not the number of characters,
+	and also pads the representation with <a data-autolink="link" class="production" href="#symbol-production"><var>&lt;symbol&gt;</var></a>s.
+	For many styles, the distinction is irrelevant, 
+	as all the <a data-autolink="link" class="production" href="#symbol-production"><var>&lt;symbol&gt;</var></a>s are single-chararacter,
+	but if a style uses multi-character <a data-autolink="link" class="production" href="#symbol-production"><var>&lt;symbol&gt;</var></a>s,
+	care must be taken not to accidentally specify <a data-autolink="property" class="property" title="width" href="#width">width</a> in terms of characters.
+
 
-<h3 id="counter-style-fallback" data-level="3.7"><span class="secno">3.7 </span>
+</p><h3 id="counter-style-fallback" data-level="3.7"><span class="secno">3.7 </span>
 Defining fallback: the <a data-autolink="property" class="property" title="fallback" href="#fallback">fallback</a> descriptor</h3>
 
 	<table class="descdef">
@@ -3373,7 +3382,7 @@ <h3 class="no-ref" id="testing">
 
 <h3 id="normative" class="no-num no-ref">
 Normative References</h3>
-<div data-fill-with="normative-references"><dl><dt id="rfc2119" title="RFC2119">[RFC2119]</dt><dd>S. Bradner. <a href="http://www.ietf.org/rfc/rfc2119.txt">Key words for use in RFCs to Indicate Requirement Levels</a>. URL: <a href="http://www.ietf.org/rfc/rfc2119.txt">http://www.ietf.org/rfc/rfc2119.txt</a></dd><dt id="css3-writing-modes" title="CSS3-WRITING-MODES">[CSS3-WRITING-MODES]</dt><dd>Elika J. Etemad; Koji Ishii. <a href="http://www.w3.org/TR/2012/WD-css3-writing-modes-20121115/">CSS Writing Modes Module Level 3</a>. 15 November 2012. W3C Working Draft. (Work in progress.) URL: <a href="http://www.w3.org/TR/2012/WD-css3-writing-modes-20121115/">http://www.w3.org/TR/2012/WD-css3-writing-modes-20121115/</a></dd></dl></div>
+<div data-fill-with="normative-references"><dl><dt id="css3-writing-modes" title="CSS3-WRITING-MODES">[CSS3-WRITING-MODES]</dt><dd>Elika J. Etemad; Koji Ishii. <a href="http://www.w3.org/TR/2012/WD-css3-writing-modes-20121115/">CSS Writing Modes Module Level 3</a>. 15 November 2012. W3C Working Draft. (Work in progress.) URL: <a href="http://www.w3.org/TR/2012/WD-css3-writing-modes-20121115/">http://www.w3.org/TR/2012/WD-css3-writing-modes-20121115/</a></dd><dt id="rfc2119" title="RFC2119">[RFC2119]</dt><dd>S. Bradner. <a href="http://www.ietf.org/rfc/rfc2119.txt">Key words for use in RFCs to Indicate Requirement Levels</a>. URL: <a href="http://www.ietf.org/rfc/rfc2119.txt">http://www.ietf.org/rfc/rfc2119.txt</a></dd></dl></div>
 
 <h3 id="informative" class="no-num no-ref">
 Informative References</h3>

css-counter-styles/Overview.src.html

@@ -1,4 +1,5 @@
 <h1>CSS Counter Styles Level 3</h1>
+
 <pre class=metadata>
 Shortname: css-counter-styles
 Level: 3
@@ -732,21 +733,20 @@ <h3 id='counter-style-width'>
 	Representations larger than the specified width are constructed as normal.
 
 	<dl>
-		<dt>auto
-		<dd>
-			This descriptor has no effect on counter representations.
-
-		<dt><var>&lt;integer></var> &amp;&amp; <var>&lt;symbol></var>
+		<dt><<integer>> &amp;&amp; <<symbol>>
 		<dd>
-			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>
+			The <<integer>> specifies a minimum width that all counter representations must reach.
+			If a counter representation would be generated using less <<symbol>>s than the specified <<integer>>
 			(before adding prefixes/suffixes/negatives),
-			prepend copies of the specified <var>&lt;symbol></var> to the representation
+			prepend copies of the specified <<symbol>> to the representation
 			until the number of symbols reaches the specified width.
 
+			The <<integer>> must be non-negative.
+			A negative value is a syntax error.
+
 			If the counter value is negative
 			and the counter style is <i>negative-capable</i>,
-			reduce the width by one or two when determining how many copies to prepend,
+			treat the minimum width as being one or two smaller 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>
 
@@ -760,9 +760,18 @@ <h3 id='counter-style-width'>
 			1 to be represented as "001", 
 			20 to be represented as "020",
 			300 to be represented as "300",
-			and -4 to be represented as "-04".
+			4000 to be represented as "4000",
+			and -5 to be represented as "-05".
 	</div>
 
+	Note: The 'width' descriptor counts the number of <em><<symbol>>s</em> used to construct the representation,
+	not the number of characters,
+	and also pads the representation with <<symbol>>s.
+	For many styles, the distinction is irrelevant, 
+	as all the <<symbol>>s are single-chararacter,
+	but if a style uses multi-character <<symbol>>s,
+	care must be taken not to accidentally specify 'width' in terms of characters.
+
 
 <h3 id='counter-style-fallback'>
 Defining fallback: the 'fallback' descriptor</h3>