Switched symbols() to put type first, refined the definition to exclude identifiers.

Author: tabatkins

css3-lists/Overview.html

@@ -2324,12 +2324,9 @@ <h2 id=symbols-function><span class=secno>9. </span> Defining Anonymous
    is:
 
   <pre><dfn
-   id=type-symbols-function>&lt;symbols-function></dfn> = symbols( &lt;symbols> [as &lt;type>]? )</pre>
+   id=type-symbols-function>&lt;symbols-function></dfn> = symbols( &lt;type>? [ &lt;string> | &lt;image> ]+ )</pre>
 
-  <p>Where &lt;symbols> is a valid value for the &lsquo;<a
-   href="#descdef-symbols"><code class=property>symbols</code></a>&rsquo;
-   descriptor in a &lsquo;<code class=css>@counter-style</code>&rsquo; rule,
-   and &lt;type> is one of the following keywords: &lsquo;<code
+  <p>Where &lt;type> is one of the following keywords: &lsquo;<code
    class=css>repeating</code>&rsquo;, &lsquo;<code
    class=css>numeric</code>&rsquo;, &lsquo;<code
    class=css>alphabetic</code>&rsquo;, &lsquo;<code
@@ -2374,7 +2371,7 @@ <h2 id=symbols-function><span class=secno>9. </span> Defining Anonymous
 
    <p>On the other hand, specifying the type of counter, like so:</p>
 
-   <pre>ol { list-style: symbols("*" "\2020" "\2021" "\A7" as repeating); }</pre>
+   <pre>ol { list-style: symbols(repeating "*" "\2020" "\2021" "\A7"); }</pre>
 
    <p>will produce lists that look like:</p>
 
@@ -2388,6 +2385,12 @@ <h2 id=symbols-function><span class=secno>9. </span> Defining Anonymous
 ‡   Seven</pre>
   </div>
 
+  <p class=note>Note that the &lsquo;<a href="#descdef-symbols"><code
+   class=css>symbols()</code></a>&rsquo; function only allows strings and
+   images, while the &lsquo;<a href="#descdef-symbols"><code
+   class=property>symbols</code></a>&rsquo; descriptor of a &lsquo;<code
+   class=css>@counter-style</code>&rsquo; rule also allows identifiers.
+
   <h2 id=ua-stylesheet><span class=secno>10. </span> Predefined Counter
    Styles</h2>
 

css3-lists/Overview.src.html

@@ -1551,9 +1551,9 @@ <h2 id='symbols-function'>
 
 	<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:</p>
 
-	<pre><dfn id='type-symbols-function'>&lt;symbols-function></dfn> = symbols( &lt;symbols> [as &lt;type>]? )</pre>
+	<pre><dfn id='type-symbols-function'>&lt;symbols-function></dfn> = symbols( &lt;type>? [ &lt;string> | &lt;image> ]+ )</pre>
 
-	<p>Where &lt;symbols> is a valid value for the 'symbols' descriptor in a ''@counter-style'' rule, and &lt;type> is one of the following keywords: ''repeating'', ''numeric'', ''alphabetic'', ''symbolic'', or ''non-repeating''.</p>
+	<p>Where &lt;type> is one of the following keywords: ''repeating'', ''numeric'', ''alphabetic'', ''symbolic'', or ''non-repeating''.</p>
 
 	<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-lower-bound">lower bound</i> of negative infinity, an <i title="counter-upper-bound">upper bound</i> of 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;symbols> as the value of the 'symbols' property.</p>
 
@@ -1575,7 +1575,7 @@ <h2 id='symbols-function'>
 
 		<p>On the other hand, specifying the type of counter, like so:</p>
 
-		<pre>ol { list-style: symbols("*" "\2020" "\2021" "\A7" as repeating); }</pre>
+		<pre>ol { list-style: symbols(repeating "*" "\2020" "\2021" "\A7"); }</pre>
 
 		<p>will produce lists that look like:</p>
 
@@ -1589,6 +1589,8 @@ <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>
+
 
 <h2 id='ua-stylesheet'>
 Predefined Counter Styles</h2>