[css-syntax] Note: "Parse a declaration list" also parses at-rules.

Author: SimonSapin

css-syntax/Overview.html

@@ -3084,6 +3084,11 @@ <h4 id=parse-a-rule><span class=secno>5.3.3. </span> <dfn
       <h4 id=parse-a-declaration><span class=secno>5.3.4. </span> <dfn
        id=parse-a-declaration0>Parse a declaration</dfn></h4>
 
+      <p class=note> Unlike "<a
+       href="#parse-a-list-of-declarations0"><i>Parse a list of
+       declarations</i></a>", this parses only a declaration and not an
+       at-rule.
+
       <p> To <a href="#parse-a-declaration0"><i>parse a declaration</i></a>:
 
       <ol>
@@ -3099,6 +3104,13 @@ <h4 id=parse-a-list-of-declarations><span class=secno>5.3.5. </span>
        <dfn id=parse-a-list-of-declarations0>Parse a list of
        declarations</dfn></h4>
 
+      <p class=note> Despite the name, this actually parses a mixed list of
+       declarations and at-rules, as CSS 2.1 does for <a
+       href="http://www.w3.org/TR/CSS21/page.html#page-box">‘<code
+       class=css>@page</code>’</a>. Unexpected at-rules (which could be all
+       of them, in a given context) are invalid and should be ignored by the
+       consumer.
+
       <p> To <a href="#parse-a-list-of-declarations0"><i>parse a list of
        declarations</i></a>:
 

css-syntax/Overview.src.html

@@ -2040,6 +2040,10 @@ <h4>
 <h4>
 <dfn>Parse a declaration</dfn></h4>
 
+	<p class=note>
+		Unlike "<i>Parse a list of declarations</i>",
+		this parses only a declaration and not an at-rule.
+
 	<p>
 		To <i>parse a declaration</i>:
 
@@ -2056,6 +2060,13 @@ <h4>
 <h4>
 <dfn>Parse a list of declarations</dfn></h4>
 
+	<p class=note>
+		Despite the name,
+		this actually parses a mixed list of declarations and at-rules,
+		as CSS 2.1 does for <a href=http://www.w3.org/TR/CSS21/page.html#page-box>''@page''</a>.
+		Unexpected at-rules (which could be all of them, in a given context)
+		are invalid and should be ignored by the consumer.
+
 	<p>
 		To <i>parse a list of declarations</i>: