Changed back to the more permissive definition of variable syntax that's just the 'value' production, but better described.

--HG--
extra : rebase_source : 8e879b4f9117a9833cbee3eef0607b9de4f3f6f2

Author: tabatkins

css-variables/Overview.html

@@ -250,9 +250,7 @@ <h2 id=defining-variables><span class=secno>2. </span> Defining Variables
     <tr>
      <th>Values:
 
-     <td><a href="#value-type"><var>&lt;value></var></a>+ [ [ ‘<code
-      class=css>,</code>’ | ‘<code class=css>/</code>’ ] <a
-      href="#value-type"><var>&lt;value></var></a>+ ]*
+     <td><a href="#value-type"><var>&lt;value></var></a>+
 
     <tr>
      <th>Initial:
@@ -282,9 +280,15 @@ <h2 id=defining-variables><span class=secno>2. </span> Defining Variables
   </table>
 
   <p> The <dfn id=value-type><var>&lt;value></var></dfn> type used in the
-   syntax above is defined as:
-
-  <pre>[ &lt;number> | &lt;percentage> | &lt;dimension> | &lt;string> | &lt;ident> | &lt;url> | &lt;function> | &lt;hash> ]</pre>
+   syntax above is defined as anything matching the "value" production in <a
+   href="http://www.w3.org/TR/CSS2/syndata.html#tokenization">CSS 2.1 Chapter
+   4.1</a> <a href="#CSS21" rel=biblioentry>[CSS21]<!--{{!CSS21}}--></a>.
+   This puts almost no restrictions on what kinds of values you can store in
+   variables. Obviously, any valid property value or component of a property
+   is allowed. Additionally, this allows things that aren't yet valid CSS,
+   like unknown keywords or functions, blocks, at-rules, and other kinds of
+   custom micro-syntaxes like what's allowed in calc(). There <em>are</em>
+   still rules, however; for example, unbalanced parentheses are invalid.
 
   <p><em>Any</em> property name starting with the prefix "var-" is a <a
    href="#variable-property"><i>variable property</i></a>. Variable
@@ -956,7 +960,7 @@ <h2 class=no-num id=property-index>Property index</h2>
     <tr>
      <th><span class=property>var-*</span>
 
-     <td>&lt;value>+ [ [ ‘,’ | ‘/’ ] &lt;value>+ ]*
+     <td>&lt;value>+
 
      <td>invalid (a keyword, but see prose)
 

css-variables/Overview.src.html

@@ -99,7 +99,7 @@ <h2 id="defining-variables">
 			<td><dfn id='variable-property' title='variable property|variable properties'>var-*</dfn>
 		<tr>
 			<th>Values:
-			<td><var>&lt;value></var>+ [ [ ',' | '/' ] <var>&lt;value></var>+ ]*
+			<td><var>&lt;value></var>+
 		<tr>
 			<th>Initial:
 			<td>invalid (a keyword, but see prose)
@@ -118,9 +118,20 @@ <h2 id="defining-variables">
 	</table>
 
 	<p>
-		The <dfn id='value-type'><var>&lt;value></var></dfn> type used in the syntax above is defined as:
-
-	<pre>[ &lt;number> | &lt;percentage> | &lt;dimension> | &lt;string> | &lt;ident> | &lt;url> | &lt;function> | &lt;hash> ]</pre>
+		The <dfn id='value-type'><var>&lt;value></var></dfn> type used in the syntax above is defined as 
+		anything matching the "value" production in <a href="http://www.w3.org/TR/CSS2/syndata.html#tokenization">CSS 2.1 Chapter 4.1</a> [[!CSS21]].
+		This puts almost no restrictions on what kinds of values you can store in variables.
+		Obviously, any valid property value
+		or component of a property
+		is allowed.
+		Additionally, this allows things that aren't yet valid CSS,
+		like unknown keywords or functions,
+		blocks,
+		at-rules,
+		and other kinds of custom micro-syntaxes like what's allowed in calc().
+		There <em>are</em> still rules, however;
+		for example,
+		unbalanced parentheses are invalid.
 
 	<p><em>Any</em> property name starting with the prefix "var-" is a <i>variable property</i>.  Variable properties are defined to be valid but meaningless as they are meant solely for allowing authors to pass custom data around their page, similar to the <a href="http://www.w3.org/TR/html5/global-attributes.html#embedding-custom-non-visible-data-with-the-data-attributes">custom data attributes</a> in HTML.  Other specifications and user agents must not assign a particular meaning to <i>variable properties</i> or attach a specific effect to them beyond the bare minimum that comes from them being valid properties.</p>