[css-counter-styles] Markup tweaks. Make it clearer that 'decimal' not being overridable is a MUST-level requirement.

--HG--
extra : rebase_source : 66504df99a31f587c96b63ac46a838017c63d644

Author: tabatkins

css-counter-styles/Overview.html

@@ -1162,7 +1162,7 @@ <h2 id=symbols-function><span class=secno>2. </span> Defining Anonymous
    Counter Styles: the ‘<a href="#descdef-symbols"><code
    class=css>symbols()</code></a>’ function</h2>
 
-  <p>The previous chapter specified a way to define custom counter styles.
+  <p> The previous chapter specified a way to define custom counter styles.
    However, counter styles are sometimes used only once in a stylesheet, and
    defining a full ‘<code class=css>@counter-style</code>’ rule can be
    overkill for this case (not to mention the possibility of unintentional
@@ -1175,22 +1175,22 @@ <h2 id=symbols-function><span class=secno>2. </span> Defining Anonymous
    class=css>symbols()</code></a>’ rule is:
 
   <pre><dfn
-   id=type-symbols-function>&lt;symbols-function></dfn> = symbols( &lt;type>? [ &lt;string> | &lt;image> ]+ )</pre>
+   id=type-symbols-function>&lt;symbols-function></dfn> = symbols( &lt;symbols-type>? [ &lt;string> | &lt;image> ]+ )</pre>
 
-  <p>Where &lt;type> is one of the following keywords: ‘<code
+  <p> Where &lt;symbols-type> is one of the following keywords: ‘<code
    class=css>repeating</code>’, ‘<code class=css>numeric</code>’,
    ‘<code class=css>alphabetic</code>’, ‘<code
    class=css>symbolic</code>’, or ‘<code
    class=css>non-repeating</code>’.
 
-  <p>The ‘<a href="#descdef-symbols"><code
+  <p> The ‘<a href="#descdef-symbols"><code
    class=css>symbols()</code></a>’ function defines an anonymous counter
    style with no <a href="#name"><i title=counter-name>name</i></a>, a <a
    href="#prefix"><i title=counter-prefix>prefix</i></a> and <a
    href="#suffix"><i title=counter-suffix>suffix</i></a> of ‘<code
    class=css>""</code>’ (the empty string), a <a href="#range"><i
    title=counter-range>range</i></a> from negative infinity to positive
-   infinity, an <a href="#fallback-style"><i title=counter-fallback>fallback
+   infinity, n <a href="#fallback-style"><i title=counter-fallback>fallback
    style</i></a> of ‘<a href="#decimal"><code
    class=css>decimal</code></a>’, and a <a href="#negative-sign"><i
    title=counter-negative>negative sign</i></a> of "\2D" ("-" hyphen-minus).
@@ -1205,11 +1205,11 @@ <h2 id=symbols-function><span class=secno>2. </span> Defining Anonymous
    class=css>1</code>’.
 
   <div class=example>
-   <p>This code:
+   <p> This code:
 
    <pre>ol { list-style: symbols("*" "\2020" "\2021" "\A7"); }</pre>
 
-   <p>will produce lists that look like:
+   <p> will produce lists that look like:
 
    <pre>
 *   One
@@ -1220,11 +1220,11 @@ <h2 id=symbols-function><span class=secno>2. </span> Defining Anonymous
 ††  Six
 ‡‡  Seven</pre>
 
-   <p>On the other hand, specifying the type of counter, like so:
+   <p> On the other hand, specifying the type of counter, like so:
 
    <pre>ol { list-style: symbols(repeating "*" "\2020" "\2021" "\A7"); }</pre>
 
-   <p>will produce lists that look like:
+   <p> will produce lists that look like:
 
    <pre>
 *   One
@@ -1236,7 +1236,7 @@ <h2 id=symbols-function><span class=secno>2. </span> Defining Anonymous
 ‡   Seven</pre>
   </div>
 
-  <p class=note>Note that the ‘<a href="#descdef-symbols"><code
+  <p class=note> Note that the ‘<a href="#descdef-symbols"><code
    class=css>symbols()</code></a>’ function only allows strings and images,
    while the ‘<a href="#descdef-symbols"><code
    class=property>symbols</code></a>’ descriptor of a ‘<code
@@ -1267,9 +1267,10 @@ <h2 id=symbols-function><span class=secno>2. </span> Defining Anonymous
   <h2 id=predefined-counters><span class=secno>3. </span> Simple Predefined
    Counter Styles</h2>
 
-  <p>The following stylesheet redefines all of the counter styles defined in
-   CSS 2.1 using the ‘<code class=css>@counter-style</code>’ rule. This
-   stylesheet is normative - UAs must include it in their UA stylesheet.
+  <p> The following stylesheet uses the ‘<code
+   class=css>@counter-style</code>’ rule to redefine all of the counter
+   styles defined in CSS 2 and CSS 2.1, plus This stylesheet is normative -
+   UAs must include it in their UA stylesheet.
 
   <h3 id=simple-numeric><span class=secno>3.1. </span> Numeric: ‘<a
    href="#decimal"><code class=css>decimal</code></a>’, ‘<a
@@ -1342,8 +1343,8 @@ <h3 id=simple-numeric><span class=secno>3.1. </span> Numeric: ‘<a
 }</bdo></pre>
 
   <p> The ‘<a href="#decimal"><code class=css>decimal</code></a>’
-   counter-style is not overridable with a @counter-style rule, so that it is
-   always available as an ultimate fallback style.
+   counter-style must not be overridable with a @counter-style rule, so that
+   it is always available as an ultimate fallback style.
 
   <h3 id=simple-alphabetic><span class=secno>3.2. </span> Alphabetic: ‘<a
    href="#lower-alpha"><code class=css>lower-alpha</code></a>’, ‘<a

css-counter-styles/Overview.src.html

@@ -820,20 +820,45 @@ <h3 id='counter-style-symbols'>
 <h2 id='symbols-function'>
 Defining Anonymous Counter Styles: the ''symbols()'' function</h2>
 
-	<p>The previous chapter specified a way to define custom counter styles.  However, counter styles are sometimes used only once in a stylesheet, and defining a full ''@counter-style'' rule can be overkill for this case (not to mention the possibility of unintentional name collisions).  To address this case, the ''symbols()'' function provides a simple way to define an anonymous counter style as an inline value.  It does not provide the full feature-set of the ''@counter-style'' rule, but provides a sufficient subset to still be useful.  The syntax of the ''symbols()'' rule is:
-
-	<pre><dfn id='type-symbols-function'>&lt;symbols-function></dfn> = symbols( &lt;type>? [ &lt;string> | &lt;image> ]+ )</pre>
+	<p>
+		The previous chapter specified a way to define custom counter styles.  
+		However, counter styles are sometimes used only once in a stylesheet, 
+		and defining a full ''@counter-style'' rule can be overkill for this case 
+		(not to mention the possibility of unintentional name collisions).  
+		To address this case, 
+		the ''symbols()'' function provides a simple way to define an anonymous counter style as an inline value.  
+		It does not provide the full feature-set of the ''@counter-style'' rule, 
+		but provides a sufficient subset to still be useful.  
+		The syntax of the ''symbols()'' rule is:
+
+	<pre><dfn id='type-symbols-function'>&lt;symbols-function></dfn> = symbols( &lt;symbols-type>? [ &lt;string> | &lt;image> ]+ )</pre>
 
-	<p>Where &lt;type> is one of the following keywords: ''repeating'', ''numeric'', ''alphabetic'', ''symbolic'', or ''non-repeating''.
+	<p>
+		Where &lt;symbols-type> is one of the following keywords: 
+		''repeating'', ''numeric'', ''alphabetic'', ''symbolic'', or ''non-repeating''.
 
-	<p>The ''symbols()'' function defines an anonymous counter style with no <i title="counter-name">name</i>, a <i title="counter-prefix">prefix</i> and <i title="counter-suffix">suffix</i> of ''""'' (the empty string), a <i title="counter-range">range</i> from negative infinity to positive infinity, an <i title="counter-fallback">fallback style</i> of ''decimal'', and a <i title="counter-negative">negative sign</i> of "\2D" ("-" hyphen-minus).  The counter style's <i title="counter-algorithm">algorithm</i> is constructed by consulting the previous chapter using the provided type - or ''symbolic'' if the type was omitted - and the provided &lt;string>s and &lt;image>s as the value of the 'symbols' property.  If the type is ''non-repeating'', the <i>first symbol value</i> is ''1''.
+	<p>
+		The ''symbols()'' function defines an anonymous counter style 
+		with no <i title="counter-name">name</i>, 
+		a <i title="counter-prefix">prefix</i> 
+		and <i title="counter-suffix">suffix</i> of ''""'' (the empty string), 
+		a <i title="counter-range">range</i> from negative infinity to positive infinity, 
+		n <i title="counter-fallback">fallback style</i> of ''decimal'', 
+		and a <i title="counter-negative">negative sign</i> of "\2D" ("-" hyphen-minus).  
+		The counter style's <i title="counter-algorithm">algorithm</i> is constructed 
+		by consulting the previous chapter using the provided type 
+		- or ''symbolic'' if the type was omitted - 
+		and the provided &lt;string>s and &lt;image>s as the value of the 'symbols' property.  
+		If the type is ''non-repeating'', the <i>first symbol value</i> is ''1''.
 
 	<div class='example'>
-		<p>This code:
+		<p>
+			This code:
 
 		<pre>ol { list-style: symbols("*" "\2020" "\2021" "\A7"); }</pre>
 
-		<p>will produce lists that look like:
+		<p>
+			will produce lists that look like:
 
 		<pre>
 *   One
@@ -844,11 +869,13 @@ <h2 id='symbols-function'>
 ††  Six
 ‡‡  Seven</pre>
 
-		<p>On the other hand, specifying the type of counter, like so:
+		<p>
+			On the other hand, specifying the type of counter, like so:
 
 		<pre>ol { list-style: symbols(repeating "*" "\2020" "\2021" "\A7"); }</pre>
 
-		<p>will produce lists that look like:
+		<p>
+			will produce lists that look like:
 
 		<pre>
 *   One
@@ -860,7 +887,9 @@ <h2 id='symbols-function'>
 ‡   Seven</pre>
 	</div>
 
-	<p class='note'>Note that the ''symbols()'' function only allows strings and images, while the 'symbols' descriptor of a ''@counter-style'' rule also allows identifiers.
+	<p class='note'>
+		Note that the ''symbols()'' function only allows strings and images, 
+		while the 'symbols' descriptor of a ''@counter-style'' rule also allows identifiers.
 
 
 <!--
@@ -891,7 +920,12 @@ <h2 id='symbols-function'>
 <h2 id='predefined-counters'>
 Simple Predefined Counter Styles</h2>
 
-	<p>The following stylesheet redefines all of the counter styles defined in CSS 2.1 using the ''@counter-style'' rule.  This stylesheet is normative - UAs must include it in their UA stylesheet.
+	<p>
+	The following stylesheet uses the ''@counter-style'' rule
+	to redefine all of the counter styles defined in CSS 2 and CSS 2.1,
+	plus 
+	This stylesheet is normative - 
+	UAs must include it in their UA stylesheet.
 
 
 <h3 id='simple-numeric'>
@@ -949,7 +983,7 @@ <h3 id='simple-numeric'>
 }</bdo></pre>
 
 	<p>
-		The ''decimal'' counter-style is not overridable with a @counter-style rule,
+		The ''decimal'' counter-style must not be overridable with a @counter-style rule,
 		so that it is always available as an ultimate fallback style.