[css-syntax] Add parse a comma-separated list of component values.

--HG--
extra : rebase_source : f44e4cc91f9c4d4e24013221e114905fe9e00114

Author: tabatkins

css-syntax/Overview.bs

@@ -2278,6 +2278,28 @@ Parse a list of component values</h4>
 			Return the list.
 	</ol>
 
+<h4 id="parse-a-comma-separated-list-of-component-values">
+Parse a comma-separated list of component values</h4>
+
+	To <dfn export>parse a comma-separated list of component values</dfn>:
+
+	<ol>
+		<li>
+			Let <var>list of cvls</var> be an initially empty list of component value lists.
+
+		<li>
+			Repeatedly <a>consume a component value</a> until an <<EOF-token>> or <<comma-token>> is returned,
+			appending the returned values (except the final <<EOF-token>> or <<comma-token>>) into a list.
+			Append the list to <var>list of cvls</var>.
+
+			If it was a <<comma-token>> that was returned,
+			repeat this step.
+
+		<li>
+			Return <var>list of cvls</var>.
+	</ol>
+
+
 <h3 id="parser-algorithms">
 Parser Algorithms</h3>
 

css-syntax/Overview.html

@@ -58,7 +58,7 @@
 </p>
   <h1 class="p-name no-ref" id=title>CSS Syntax Module Level 3</h1>
   <h2 class="no-num no-toc no-ref heading settled heading" id=subtitle><span class=content>Editor’s Draft,
-    <span class=dt-updated><span class=value-title title=20140402>2 April 2014</span></span></span></h2>
+    <span class=dt-updated><span class=value-title title=20140414>14 April 2014</span></span></span></h2>
   <div data-fill-with=spec-metadata><dl><dt>This version:<dd><a class=u-url href=http://dev.w3.org/csswg/css-syntax/>http://dev.w3.org/csswg/css-syntax/</a><dt>Latest version:<dd><a href=http://www.w3.org/TR/css-syntax-3/>http://www.w3.org/TR/css-syntax-3/</a><dt>Editor’s Draft:<dd><a href=http://dev.w3.org/csswg/css-syntax/>http://dev.w3.org/csswg/css-syntax/</a><dt>Previous Versions:<dd><a href=http://www.w3.org/TR/2014/CR-css-syntax-3-20140220/ rel=previous>http://www.w3.org/TR/2014/CR-css-syntax-3-20140220/</a><dd><a href=http://www.w3.org/TR/2013/WD-css-syntax-3-20131105/ rel=previous>http://www.w3.org/TR/2013/WD-css-syntax-3-20131105/</a><dd><a href=http://www.w3.org/TR/2013/WD-css-syntax-3-20130919/ rel=previous>http://www.w3.org/TR/2013/WD-css-syntax-3-20130919/</a>
     <dt>Feedback:</dt>
         <dd><a href="mailto:www-style@w3.org?subject=%5Bcss-syntax%5D%20feedback">www-style@w3.org</a>
@@ -155,7 +155,8 @@ <h2 class="no-num no-toc no-ref heading settled heading" id=contents><span class
 			<li><a href=#parse-a-declaration><span class=secno>5.3.4</span> Parse a declaration</a>
 			<li><a href=#parse-a-list-of-declarations><span class=secno>5.3.5</span> Parse a list of declarations</a>
 			<li><a href=#parse-a-component-value><span class=secno>5.3.6</span> Parse a component value</a>
-			<li><a href=#parse-a-list-of-component-values><span class=secno>5.3.7</span> Parse a list of component values</a></ul>
+			<li><a href=#parse-a-list-of-component-values><span class=secno>5.3.7</span> Parse a list of component values</a>
+			<li><a href=#parse-a-comma-separated-list-of-component-values><span class=secno>5.3.8</span> Parse a comma-separated list of component values</a></ul>
 		<li><a href=#parser-algorithms><span class=secno>5.4</span> Parser Algorithms</a>
 			<ul class=toc>
 			<li><a href=#consume-a-list-of-rules><span class=secno>5.4.1</span> Consume a list of rules</a>
@@ -176,7 +177,7 @@ <h2 class="no-num no-toc no-ref heading settled heading" id=contents><span class
 	<li><a href=#css-stylesheets><span class=secno>8</span> CSS stylesheets</a>
 		<ul class=toc>
 		<li><a href=#style-rules><span class=secno>8.1</span> Style rules</a>
-		<li><a href=#charset-rule><span class=secno>8.2</span> The <span class=css data-link-type=maybe title=@charset>@charset</span> Rule</a></ul>
+		<li><a href=#charset-rule><span class=secno>8.2</span> The <a class=css data-link-type=maybe href=#at-ruledef-charset title=@charset>@charset</a> Rule</a></ul>
 	<li><a href=#serialization><span class=secno>9</span> Serialization</a>
 		<ul class=toc>
 		<li><a href=#serializing-anb><span class=secno>9.1</span> Serializing <var>&lt;an+b&gt;</var></a></ul>
@@ -260,7 +261,7 @@ <h2 class="heading settled heading" data-level=2 id=syntax-description><span cla
 <p>		"<code>color: blue;</code>" is a declaration specifying that,
 		for the elements that match the selector,
 		their <a class=property data-link-type=propdesc href=http://dev.w3.org/csswg/css-color-3/#color0 title=color>color</a> property should have the value <span class=css data-link-type=maybe title=blue>blue</span>.
-		Similarly, their <a class=property data-link-type=propdesc href=http://dev.w3.org/csswg/css-text-decor-3/#text-decoration title=text-decoration>text-decoration</a> property should have the value <span class=css data-link-type=maybe title=underline>underline</span>.
+		Similarly, their <a class=property data-link-type=propdesc href=http://dev.w3.org/csswg/css-text-decor-3/#propdef-text-decoration title=text-decoration>text-decoration</a> property should have the value <span class=css data-link-type=maybe title=underline>underline</span>.
 	</div>
 
 <p>	At-rules are all different, but they have a basic structure in common.
@@ -3638,7 +3639,7 @@ <h3 class="heading settled heading" data-level=5.3 id=parser-entry-points><span
 
 			<li>
 				"<a data-link-type=dfn href=#parse-a-component-value0 title="parse a component value">Parse a component value</a>" is for things that need to consume a single value,
-				like the parsing rules for <a class=css data-link-type=maybe href=http://dev.w3.org/csswg/css-values-3/#attr title=attr()>attr()</a>.
+				like the parsing rules for <a class=css data-link-type=maybe href=http://dev.w3.org/csswg/css-values-3/#funcdef-attr title=attr()>attr()</a>.
 
 			<li>
 				"<a data-link-type=dfn href=#parse-a-list-of-component-values0 title="parse a list of component values">Parse a list of component values</a>" is for the contents of presentational attributes,
@@ -3805,6 +3806,28 @@ <h4 class="heading settled heading" data-level=5.3.7 id=parse-a-list-of-componen
 			Return the list.
 	</ol>
 
+<h4 class="heading settled heading" data-level=5.3.8 id=parse-a-comma-separated-list-of-component-values><span class=secno>5.3.8 </span><span class=content>
+Parse a comma-separated list of component values</span><a class=self-link href=#parse-a-comma-separated-list-of-component-values></a></h4>
+
+<p>	To <dfn data-dfn-type=dfn data-export="" id=parse-a-comma-separated-list-of-component-values0>parse a comma-separated list of component values<a class=self-link href=#parse-a-comma-separated-list-of-component-values0></a></dfn>:
+
+	<ol>
+		<li>
+			Let <var>list of cvls</var> be an initially empty list of component value lists.
+
+		<li>
+			Repeatedly <a data-link-type=dfn href=#consume-a-component-value0 title="consume a component value">consume a component value</a> until an <a class="production css-code" data-link-type=type href=#typedef-eof-token title="<eof-token>">&lt;EOF-token&gt;</a> or <a class="production css-code" data-link-type=type href=#typedef-comma-token title="<comma-token>">&lt;comma-token&gt;</a> is returned,
+			appending the returned values (except the final <a class="production css-code" data-link-type=type href=#typedef-eof-token title="<eof-token>">&lt;EOF-token&gt;</a> or <a class="production css-code" data-link-type=type href=#typedef-comma-token title="<comma-token>">&lt;comma-token&gt;</a>) into a list.
+			Append the list to <var>list of cvls</var>.
+
+<p>			If it was a <a class="production css-code" data-link-type=type href=#typedef-comma-token title="<comma-token>">&lt;comma-token&gt;</a> that was returned,
+			repeat this step.
+
+		<li>
+			Return <var>list of cvls</var>.
+	</ol>
+
+
 <h3 class="heading settled heading" data-level=5.4 id=parser-algorithms><span class=secno>5.4 </span><span class=content>
 Parser Algorithms</span><a class=self-link href=#parser-algorithms></a></h3>
 
@@ -4415,7 +4438,7 @@ <h3 class="heading settled heading" data-level=7.1 id=declaration-rule-list><spa
 <p>		This is a complete and sufficient definition of the rule’s grammar.
 
 <p>		For another example,
-		<span class=css data-link-type=maybe title=@keyframes>@keyframes</span> rules are more complex,
+		<a class=css data-link-type=maybe href=http://dev.w3.org/csswg/css-animations-1/#at-ruledef-keyframes title=@keyframes>@keyframes</a> rules are more complex,
 		interpreting their prelude as a name and containing keyframes rules in their block
 		Their grammar is:
 
@@ -4449,15 +4472,15 @@ <h3 class="heading settled heading" data-level=7.1 id=declaration-rule-list><spa
 	and unrecognized rules must similarly be removed from the rule’s value.
 
 	<div class=example>
-		For example, the grammar for <span class=css data-link-type=maybe title=@keyframes>@keyframes</span> in the previous example must,
+		For example, the grammar for <a class=css data-link-type=maybe href=http://dev.w3.org/csswg/css-animations-1/#at-ruledef-keyframes title=@keyframes>@keyframes</a> in the previous example must,
 		in addition to what is written there,
 		define that the only allowed rules are <a class="production css-code" data-link-type=type title="<keyframe-rule>">&lt;keyframe-rule&gt;</a>s,
 		which are defined as:
 
 <pre><a class="production css-code" data-link-type=type title="<keyframe-rule>">&lt;keyframe-rule&gt;</a> = <a class="production css-code" data-link-type=type title="<keyframe-selector>">&lt;keyframe-selector&gt;</a> { <a class="production css-code" data-link-type=type href=#typedef-declaration-list title="<declaration-list>">&lt;declaration-list&gt;</a> }</pre>
 <p>		Keyframe rules, then,
 		must further define that they accept as declarations all animatable CSS properties,
-		plus the <a class=property data-link-type=propdesc href=http://dev.w3.org/csswg/css-animations-1/#animation-timing-function title=animation-timing-function>animation-timing-function</a> property,
+		plus the <a class=property data-link-type=propdesc href=http://dev.w3.org/csswg/css-animations-1/#propdef-animation-timing-function title=animation-timing-function>animation-timing-function</a> property,
 		but that they do not interact with the cascade.
 	</div>
 
@@ -4522,7 +4545,7 @@ <h3 class="heading settled heading" data-level=8.1 id=style-rules><span class=se
 
 	<p class=example>
 		For example, qualified rules inside <a class=css data-link-type=maybe href=http://dev.w3.org/csswg/css-conditional-3/#at-ruledef-media title=@media>@media</a> rules <a data-biblio-type=informative data-link-type=biblio href=#css3-conditional title=css3-conditional>[CSS3-CONDITIONAL]</a> are style rules,
-		but qualified rules inside <span class=css data-link-type=maybe title=@keyframes>@keyframes</span> rules are not <a data-biblio-type=informative data-link-type=biblio href=#css3-animations title=css3-animations>[CSS3-ANIMATIONS]</a>.
+		but qualified rules inside <a class=css data-link-type=maybe href=http://dev.w3.org/csswg/css-animations-1/#at-ruledef-keyframes title=@keyframes>@keyframes</a> rules are not <a data-biblio-type=informative data-link-type=biblio href=#css3-animations title=css3-animations>[CSS3-ANIMATIONS]</a>.
 
 <h3 class="heading settled heading" data-level=8.2 id=charset-rule><span class=secno>8.2 </span><span class=content>
 The <a class=css data-link-type=maybe href=#at-ruledef-charset title=@charset>@charset</a> Rule</span><a class=self-link href=#charset-rule></a></h3>
@@ -5156,6 +5179,7 @@ <h2 class="no-num no-ref heading settled heading" id=index><span class=content>
 <li>non-ASCII code point, <a href=#non-ascii-code-point title="section 4.2">4.2</a>
 <li>non-printable code point, <a href=#non-printable-code-point title="section 4.2">4.2</a>
 <li>&lt;number-token&gt;, <a href=#typedef-number-token title="section 4">4</a>
+<li>parse a comma-separated list of component values, <a href=#parse-a-comma-separated-list-of-component-values0 title="section 5.3.8">5.3.8</a>
 <li>parse a component value, <a href=#parse-a-component-value0 title="section 5.3.6">5.3.6</a>
 <li>parse a CSS stylesheet, <a href=#parse-a-css-stylesheet title="section 8">8</a>
 <li>parse a declaration, <a href=#parse-a-declaration0 title="section 5.3.4">5.3.4</a>