[css-animations] Clarify findRule/deleteRule behavior (bug 14788)

Author: Sylvain Galineau

css-animations/Overview.bs

@@ -934,8 +934,8 @@ IDL Definition</h4>
 	  readonly attribute CSSRuleList cssRules;
 
 	  void            appendRule(DOMString rule);
-	  void            deleteRule(DOMString key);
-	  CSSKeyframeRule? findRule(DOMString key);
+	  void            deleteRule(DOMString select);
+	  CSSKeyframeRule? findRule(DOMString select);
 	};
 	</pre>
 
@@ -982,20 +982,19 @@ The <code>appendRule</code> method</h4>
 <h4 id="interface-csskeyframesrule-deleterule">
 The <code>deleteRule</code> method</h4>
 
-	The <dfn method for="CSSKeyframesRule">deleteRule()</dfn> deletes the <a idl>CSSKeyframeRule</a>
-	with the passed key. If a rule with this key does not exist, the method does nothing.
-
-	If multiple rules are specified for the passed key, the last one is deleted.
+	The <dfn method for="CSSKeyframesRule">deleteRule()</dfn> deletes the 
+    last declared <a idl>CSSKeyframeRule</a> matching the specified keyframe selector. 
+    If no matching rule exists, the method does nothing.
 
 	Parameters:
 
 	<dl>
 
-		<dt><dfn argument for="CSSKeyframesRule/deleteRule()">key</dfn> of type <a interface>DOMString</a>
+		<dt><dfn argument for="CSSKeyframesRule/deleteRule()">select</dfn> of type <a interface>DOMString</a>
 		<dd>
-			The keyframe selector of the rule to be deleted: a comma-separated list of either percentage values between 0% and 100% or one of the keywords ''from'' or ''to'', which resolve to 0% and 100%, respectively.
+			The keyframe selector of the rule to be deleted: a comma-separated list of percentage values between 0% and 100% or the keywords ''from'' or ''to'' which resolve to 0% and 100%, respectively.
 
-            The number and order of the values in the specified keyframe selector must match those of the targeted keyframe rule(s).  The match is not sensitive to white-space.
+            The number and order of the values in the specified keyframe selector must match those of the targeted keyframe rule(s).  The match is not sensitive to white space around the values in the list.
 	</dl>
 
 	No Return Value
@@ -1006,19 +1005,18 @@ The <code>deleteRule</code> method</h4>
 <h4 id="interface-csskeyframesrule-findrule">
 The <code>findRule</code> method</h4>
 
-	The <dfn method for="CSSKeyframesRule">findRule()</dfn> returns the rule with a key matching
-	the passed key. If no such rule exists, a null value is returned.
-
-	If multiple rules are specified for the passed key, the last one is returned.
+	The <dfn method for="CSSKeyframesRule">findRule()</dfn> returns the 
+    last declared <a idl>CSSKeyframeRule</a> matching the specified keyframe selector.
+    If no matching rule exists, the method does nothing.
 
 	Parameters:
 
 	<dl>
-		<dt><dfn argument for="CSSKeyframesRule/findRule()">key</dfn> of type <a interface>DOMString</a>
+		<dt><dfn argument for="CSSKeyframesRule/findRule()">select</dfn> of type <a interface>DOMString</a>
 		<dd>
-			The keyframe selector of the rule to be retrieved: a comma-separated list of either percentage values between 0% and 100% or one of the keywords ''from'' or ''to'', which resolve to 0% and 100%, respectively.
+			The keyframe selector of the rule to be deleted: a comma-separated list of percentage values between 0% and 100% or the keywords ''from'' or ''to'' which resolve to 0% and 100%, respectively.
 
-            The number and order of the values in the specified keyframe selector must match those of the targeted keyframe rule(s). The match is not sensitive to white-space.
+            The number and order of the values in the specified keyframe selector must match those of the targeted keyframe rule(s). The match is not sensitive to white space around the values in the list.
     </dl>
 
 	Return Value:

css-animations/Overview.html

@@ -56,7 +56,7 @@
 </p>
   <h1 class="p-name no-ref" id=title>CSS Animations Level 1</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=20141208>8 December 2014</span></span></span></h2>
+    <span class=dt-updated><span class=value-title title=20150109>9 January 2015</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/css3-animations/>http://dev.w3.org/csswg/css3-animations/</a><dt>Latest version:<dd><a href=http://www.w3.org/TR/css3-animations/>http://www.w3.org/TR/css3-animations/</a><dt>Editor’s Draft:<dd><a href=http://dev.w3.org/csswg/css3-animations/>http://dev.w3.org/csswg/css3-animations/</a><dt>Previous Versions:<dd><a href=http://www.w3.org/TR/2013/WD-css3-animations-20130219/ rel=previous>http://www.w3.org/TR/2013/WD-css3-animations-20130219/</a><dd><a href=http://www.w3.org/TR/2012/WD-css3-animations-20120403/ rel=previous>http://www.w3.org/TR/2012/WD-css3-animations-20120403/</a>
     <dt>Feedback:</dt>
         <dd><a href="mailto:www-style@w3.org?subject=%5Bcss-animations%5D%20feedback">www-style@w3.org</a>
@@ -950,8 +950,8 @@ <h4 class="heading settled heading" data-level=6.3.1 id=interface-csskeyframesru
   readonly attribute <a data-link-type=idl href=http://dev.w3.org/csswg/cssom-1/#cssrulelist title=cssrulelist>CSSRuleList</a> <a class=idl-code data-global-name="CSSKeyframesRule<interface>/cssrules<attribute>" data-link-for=CSSKeyframesRule data-link-type=attribute href=#dom-csskeyframesrule-cssrules title=cssrules>cssRules</a>;
 
   void            <a class=idl-code data-global-name="CSSKeyframesRule<interface>/appendrule()<method>" data-link-for=CSSKeyframesRule data-link-type=method href=#dom-csskeyframesrule-appendrule title=appendrule()>appendRule</a>(DOMString <a class=idl-code data-global-name="CSSKeyframesRule<interface>/appendRule()<method>/rule<argument>" data-link-for=CSSKeyframesRule/appendRule() data-link-type=argument href=#dom-csskeyframesruleappendrule-rule title=rule>rule</a>);
-  void            <a class=idl-code data-global-name="CSSKeyframesRule<interface>/deleterule()<method>" data-link-for=CSSKeyframesRule data-link-type=method href=#dom-csskeyframesrule-deleterule title=deleterule()>deleteRule</a>(DOMString <a class=idl-code data-global-name="CSSKeyframesRule<interface>/deleteRule()<method>/key<argument>" data-link-for=CSSKeyframesRule/deleteRule() data-link-type=argument href=#dom-csskeyframesruledeleterule-key title=key>key</a>);
-  <a data-link-type=idl href=#dom-csskeyframerule title=csskeyframerule>CSSKeyframeRule</a>? <a class=idl-code data-global-name="CSSKeyframesRule<interface>/findrule()<method>" data-link-for=CSSKeyframesRule data-link-type=method href=#dom-csskeyframesrule-findrule title=findrule()>findRule</a>(DOMString <a class=idl-code data-global-name="CSSKeyframesRule<interface>/findRule()<method>/key<argument>" data-link-for=CSSKeyframesRule/findRule() data-link-type=argument href=#dom-csskeyframesrulefindrule-key title=key>key</a>);
+  void            <a class=idl-code data-global-name="CSSKeyframesRule<interface>/deleterule()<method>" data-link-for=CSSKeyframesRule data-link-type=method href=#dom-csskeyframesrule-deleterule title=deleterule()>deleteRule</a>(DOMString <a class=idl-code data-global-name="CSSKeyframesRule<interface>/deleteRule()<method>/select<argument>" data-link-for=CSSKeyframesRule/deleteRule() data-link-type=argument href=#dom-csskeyframesruledeleterule-select title=select>select</a>);
+  <a data-link-type=idl href=#dom-csskeyframerule title=csskeyframerule>CSSKeyframeRule</a>? <a class=idl-code data-global-name="CSSKeyframesRule<interface>/findrule()<method>" data-link-for=CSSKeyframesRule data-link-type=method href=#dom-csskeyframesrule-findrule title=findrule()>findRule</a>(DOMString <a class=idl-code data-global-name="CSSKeyframesRule<interface>/findRule()<method>/select<argument>" data-link-for=CSSKeyframesRule/findRule() data-link-type=argument href=#dom-csskeyframesrulefindrule-select title=select>select</a>);
 };
 </pre>
 <h4 class="heading settled heading" data-level=6.3.2 id=interface-csskeyframesrule-attributes><span class=secno>6.3.2 </span><span class=content>
@@ -997,20 +997,19 @@ <h4 class="heading settled heading" data-level=6.3.3 id=interface-csskeyframesru
 <h4 class="heading settled heading" data-level=6.3.4 id=interface-csskeyframesrule-deleterule><span class=secno>6.3.4 </span><span class=content>
 The <code>deleteRule</code> method</span><a class=self-link href=#interface-csskeyframesrule-deleterule></a></h4>
 
-<p>	The <dfn class=idl-code data-dfn-for=CSSKeyframesRule data-dfn-type=method data-export="" id=dom-csskeyframesrule-deleterule title=deleterule()>deleteRule()<a class=self-link href=#dom-csskeyframesrule-deleterule></a></dfn> deletes the <a data-link-type=idl href=#dom-csskeyframerule title=csskeyframerule>CSSKeyframeRule</a>
-	with the passed key. If a rule with this key does not exist, the method does nothing.
-
-<p>	If multiple rules are specified for the passed key, the last one is deleted.
+<p>	The <dfn class=idl-code data-dfn-for=CSSKeyframesRule data-dfn-type=method data-export="" id=dom-csskeyframesrule-deleterule title=deleterule()>deleteRule()<a class=self-link href=#dom-csskeyframesrule-deleterule></a></dfn> deletes the 
+    last declared <a data-link-type=idl href=#dom-csskeyframerule title=csskeyframerule>CSSKeyframeRule</a> matching the specified keyframe selector. 
+    If no matching rule exists, the method does nothing.
 
 <p>	Parameters:
 
 	<dl>
 
-		<dt><dfn class=idl-code data-dfn-for=CSSKeyframesRule/deleteRule() data-dfn-type=argument data-export="" id=dom-csskeyframesruledeleterule-key>key<a class=self-link href=#dom-csskeyframesruledeleterule-key></a></dfn> of type <a class=idl-code data-link-type=interface title=domstring>DOMString</a>
+		<dt><dfn class=idl-code data-dfn-for=CSSKeyframesRule/deleteRule() data-dfn-type=argument data-export="" id=dom-csskeyframesruledeleterule-select>select<a class=self-link href=#dom-csskeyframesruledeleterule-select></a></dfn> of type <a class=idl-code data-link-type=interface title=domstring>DOMString</a>
 		<dd>
-			The keyframe selector of the rule to be deleted: a comma-separated list of either percentage values between 0% and 100% or one of the keywords <span class=css data-link-type=maybe title=from>from</span> or <span class=css data-link-type=maybe title=to>to</span>, which resolve to 0% and 100%, respectively.
+			The keyframe selector of the rule to be deleted: a comma-separated list of percentage values between 0% and 100% or the keywords <span class=css data-link-type=maybe title=from>from</span> or <span class=css data-link-type=maybe title=to>to</span> which resolve to 0% and 100%, respectively.
 
-<p>            The number and order of the values in the specified keyframe selector must match those of the targeted keyframe rule(s).  The match is not sensitive to white-space.
+<p>            The number and order of the values in the specified keyframe selector must match those of the targeted keyframe rule(s).  The match is not sensitive to white space around the values in the list.
 	</dl>
 
 <p>	No Return Value
@@ -1021,19 +1020,18 @@ <h4 class="heading settled heading" data-level=6.3.4 id=interface-csskeyframesru
 <h4 class="heading settled heading" data-level=6.3.5 id=interface-csskeyframesrule-findrule><span class=secno>6.3.5 </span><span class=content>
 The <code>findRule</code> method</span><a class=self-link href=#interface-csskeyframesrule-findrule></a></h4>
 
-<p>	The <dfn class=idl-code data-dfn-for=CSSKeyframesRule data-dfn-type=method data-export="" id=dom-csskeyframesrule-findrule title=findrule()>findRule()<a class=self-link href=#dom-csskeyframesrule-findrule></a></dfn> returns the rule with a key matching
-	the passed key. If no such rule exists, a null value is returned.
-
-<p>	If multiple rules are specified for the passed key, the last one is returned.
+<p>	The <dfn class=idl-code data-dfn-for=CSSKeyframesRule data-dfn-type=method data-export="" id=dom-csskeyframesrule-findrule title=findrule()>findRule()<a class=self-link href=#dom-csskeyframesrule-findrule></a></dfn> returns the 
+    last declared <a data-link-type=idl href=#dom-csskeyframerule title=csskeyframerule>CSSKeyframeRule</a> matching the specified keyframe selector.
+    If no matching rule exists, the method does nothing.
 
 <p>	Parameters:
 
 	<dl>
-		<dt><dfn class=idl-code data-dfn-for=CSSKeyframesRule/findRule() data-dfn-type=argument data-export="" id=dom-csskeyframesrulefindrule-key>key<a class=self-link href=#dom-csskeyframesrulefindrule-key></a></dfn> of type <a class=idl-code data-link-type=interface title=domstring>DOMString</a>
+		<dt><dfn class=idl-code data-dfn-for=CSSKeyframesRule/findRule() data-dfn-type=argument data-export="" id=dom-csskeyframesrulefindrule-select>select<a class=self-link href=#dom-csskeyframesrulefindrule-select></a></dfn> of type <a class=idl-code data-link-type=interface title=domstring>DOMString</a>
 		<dd>
-			The keyframe selector of the rule to be retrieved: a comma-separated list of either percentage values between 0% and 100% or one of the keywords <span class=css data-link-type=maybe title=from>from</span> or <span class=css data-link-type=maybe title=to>to</span>, which resolve to 0% and 100%, respectively.
+			The keyframe selector of the rule to be deleted: a comma-separated list of percentage values between 0% and 100% or the keywords <span class=css data-link-type=maybe title=from>from</span> or <span class=css data-link-type=maybe title=to>to</span> which resolve to 0% and 100%, respectively.
 
-<p>            The number and order of the values in the specified keyframe selector must match those of the targeted keyframe rule(s). The match is not sensitive to white-space.
+<p>            The number and order of the values in the specified keyframe selector must match those of the targeted keyframe rule(s). The match is not sensitive to white space around the values in the list.
     </dl>
 
 <p>	Return Value:
@@ -1285,9 +1283,7 @@ <h2 class="no-num no-ref heading settled heading" id=index><span class=content>
 </ul><li>findrule(), <a href=#dom-csskeyframesrule-findrule title="section 6.3.5">6.3.5</a>
 <li>forwards, <a href=#valuedef-forwards title="section 4.9">4.9</a>
 <li>infinite, <a href=#valuedef-infinite title="section 4.5">4.5</a>
-<li>key<ul><li>argument for CSSKeyframesRule/deleteRule(), <a href=#dom-csskeyframesruledeleterule-key title="section 6.3.4">6.3.4</a>
-<li>argument for CSSKeyframesRule/findRule(), <a href=#dom-csskeyframesrulefindrule-key title="section 6.3.5">6.3.5</a>
-</ul><li>KEYFRAME_RULE, <a href=#dom-cssrule-keyframe_rule title="section 6.1.1">6.1.1</a>
+<li>KEYFRAME_RULE, <a href=#dom-cssrule-keyframe_rule title="section 6.1.1">6.1.1</a>
 <li>@keyframes, <a href=#at-ruledef-keyframes title="section 4">4</a>
 <li>KEYFRAMES_RULE, <a href=#dom-cssrule-keyframes_rule title="section 6.1.1">6.1.1</a>
 <li>keyText, <a href=#dom-csskeyframerule-keytext title="section 6.2.2">6.2.2</a>
@@ -1302,7 +1298,9 @@ <h2 class="no-num no-ref heading settled heading" id=index><span class=content>
 </ul><li>reverse, <a href=#valuedef-reverse title="section 4.6">4.6</a>
 <li>rule, <a href=#dom-csskeyframesruleappendrule-rule title="section 6.3.3">6.3.3</a>
 <li>running, <a href=#valuedef-running title="section 4.7">4.7</a>
-<li>&lt;single-animation&gt;, <a href=#typedef-single-animation title="section 4.10">4.10</a>
+<li>select<ul><li>argument for CSSKeyframesRule/deleteRule(), <a href=#dom-csskeyframesruledeleterule-select title="section 6.3.4">6.3.4</a>
+<li>argument for CSSKeyframesRule/findRule(), <a href=#dom-csskeyframesrulefindrule-select title="section 6.3.5">6.3.5</a>
+</ul><li>&lt;single-animation&gt;, <a href=#typedef-single-animation title="section 4.10">4.10</a>
 <li>&lt;single-animation-direction&gt;, <a href=#typedef-single-animation-direction title="section 4.6">4.6</a>
 <li>&lt;single-animation-fill-mode&gt;, <a href=#typedef-single-animation-fill-mode title="section 4.9">4.9</a>
 <li>&lt;single-animation-iteration-count&gt;, <a href=#typedef-single-animation-iteration-count title="section 4.5">4.5</a>