[css-syntax] Fix cross-references for <{-token> and the like.

Author: SimonSapin

css-syntax/Overview.html

@@ -315,9 +315,9 @@ <h3 class="heading settled heading" data-level=2.2 id=error-handling><span class
 			nothing is invalid from the parser’s standpoint;
 			it’s all part of the at-rule’s prelude.
 			Encountering a <a class="production css-code" data-link-type=type href=#typedef-semicolon-token title="<semicolon-token>">&lt;semicolon-token&gt;</a> ends the at-rule immediately,
-			while encountering an opening curly-brace &lt;&lt;{-token&gt;&gt; starts the at-rule’s body.
+			while encountering an opening curly-brace <a href=#tokendef-open-curly>&lt;{-token&gt;</a> starts the at-rule’s body.
 			The at-rule seeks forward, matching blocks (content surrounded by (), {}, or [])
-			until it finds a closing curly-brace &lt;&lt;}-token&gt;&gt; that isn’t matched by anything else
+			until it finds a closing curly-brace <a href=#tokendef-close-curly>&lt;}-token&gt;</a> that isn’t matched by anything else
 			or inside of another block.
 			The contents of the at-rule are then interpreted according to the at-rule’s own grammar.
 
@@ -1926,11 +1926,11 @@ <h4 class="heading settled heading" data-level=4.3.1 id=consume-a-token><span cl
 
 		<dt>U+0028 LEFT PARENTHESIS (()
 		<dd>
-			Return a &lt;&lt;(-token&gt;&gt;.
+			Return a <a href=#tokendef-open-paren>&lt;(-token&gt;</a>.
 
 		<dt>U+0029 RIGHT PARENTHESIS ())
 		<dd>
-			Return a &lt;&lt;)-token&gt;&gt;.
+			Return a <a href=#tokendef-close-paren>&lt;)-token&gt;</a>.
 
 		<dt>U+002A ASTERISK (*)
 		<dd>
@@ -2044,7 +2044,7 @@ <h4 class="heading settled heading" data-level=4.3.1 id=consume-a-token><span cl
 
 		<dt>U+005B LEFT SQUARE BRACKET ([)
 		<dd>
-			Return a &lt;&lt;[-token&gt;&gt;.
+			Return a <a href=#tokendef-open-square>&lt;[-token&gt;</a>.
 
 		<dt>U+005C REVERSE SOLIDUS (\)
 		<dd>
@@ -2060,7 +2060,7 @@ <h4 class="heading settled heading" data-level=4.3.1 id=consume-a-token><span cl
 
 		<dt>U+005D RIGHT SQUARE BRACKET (])
 		<dd>
-			Return a &lt;&lt;]-token&gt;&gt;.
+			Return a <a href=#tokendef-close-square>&lt;]-token&gt;</a>.
 
 		<dt>U+005E CIRCUMFLEX ACCENT (^)
 		<dd>
@@ -2075,11 +2075,11 @@ <h4 class="heading settled heading" data-level=4.3.1 id=consume-a-token><span cl
 
 		<dt>U+007B LEFT CURLY BRACKET ({)
 		<dd>
-			Return a &lt;&lt;{-token&gt;&gt;.
+			Return a <a href=#tokendef-open-curly>&lt;{-token&gt;</a>.
 
 		<dt>U+007D RIGHT CURLY BRACKET (})
 		<dd>
-			Return a &lt;&lt;}-token&gt;&gt;.
+			Return a <a href=#tokendef-close-curly>&lt;}-token&gt;</a>.
 
 		<dt><a data-link-type=dfn href=#digit title=digit>digit</a>
 		<dd>
@@ -2805,15 +2805,15 @@ <h2 class="heading settled heading" data-level=5 id=parsing><span class=secno>5
 		<dd>
 			Any token produced by the tokenizer
 			except for <a class="production css-code" data-link-type=type href=#typedef-function-token title="<function-token>">&lt;function-token&gt;</a>s,
-			&lt;&lt;{-token&gt;&gt;s,
-			&lt;&lt;(-token&gt;&gt;s,
-			and &lt;&lt;[-token&gt;&gt;s.
+			<a href=#tokendef-open-curly>&lt;{-token&gt;</a>s,
+			<a href=#tokendef-open-paren>&lt;(-token&gt;</a>s,
+			and <a href=#tokendef-open-square>&lt;[-token&gt;</a>s.
 
 <p class=note>			Note: The non-preserved tokens listed above are always consumed into higher-level objects,
 			either functions or simple blocks,
 			and so never appear in any parser output themselves.
 
-<p class=note>			Note: The tokens &lt;&lt;}-token&gt;&gt;s, &lt;&lt;)-token&gt;&gt;s, &lt;&lt;]-token&gt;&gt;, <a class="production css-code" data-link-type=type href=#typedef-bad-string-token title="<bad-string-token>">&lt;bad-string-token&gt;</a>, and <a class="production css-code" data-link-type=type href=#typedef-bad-url-token title="<bad-url-token>">&lt;bad-url-token&gt;</a> are always parse errors,
+<p class=note>			Note: The tokens <a href=#tokendef-close-curly>&lt;}-token&gt;</a>s, <a href=#tokendef-close-paren>&lt;)-token&gt;</a>s, <a href=#tokendef-close-square>&lt;]-token&gt;</a>, <a class="production css-code" data-link-type=type href=#typedef-bad-string-token title="<bad-string-token>">&lt;bad-string-token&gt;</a>, and <a class="production css-code" data-link-type=type href=#typedef-bad-url-token title="<bad-url-token>">&lt;bad-url-token&gt;</a> are always parse errors,
 			but they are preserved in the token stream by this specification to allow other specs,
 			such as Media Queries,
 			to define more fine-grainted error-handling
@@ -2826,7 +2826,7 @@ <h2 class="heading settled heading" data-level=5 id=parsing><span class=secno>5
 
 		<dt><dfn data-dfn-type=dfn data-noexport="" id=simple-block>simple block<a class=self-link href=#simple-block></a></dfn>
 		<dd>
-			A simple block has an associated token (either a &lt;&lt;[-token&gt;&gt;, &lt;&lt;(-token&gt;&gt;, or &lt;&lt;{-token&gt;&gt;)
+			A simple block has an associated token (either a <a href=#tokendef-open-square>&lt;[-token&gt;</a>, <a href=#tokendef-open-paren>&lt;(-token&gt;</a>, or <a href=#tokendef-open-curly>&lt;{-token&gt;</a>)
 			and a value consisting of a list of component values.
 	</dl>
 
@@ -3801,13 +3801,13 @@ <h4 class="heading settled heading" data-level=5.4.2 id=consume-an-at-rule><span
 		<dd>
 			Return the at-rule.
 
-		<dt>&lt;&lt;{-token&gt;&gt;
+		<dt><a href=#tokendef-open-curly>&lt;{-token&gt;</a>
 		<dd>
 			<a data-link-type=dfn href=#consume-a-simple-block0 title="consume a simple block">Consume a simple block</a>
 			and assign it to the at-rule’s block.
 			Return the at-rule.
 
-		<dt><a data-link-type=dfn href=#simple-block title="simple block">simple block</a> with an associated token of &lt;&lt;{-token&gt;&gt;
+		<dt><a data-link-type=dfn href=#simple-block title="simple block">simple block</a> with an associated token of <a href=#tokendef-open-curly>&lt;{-token&gt;</a>
 		<dd>
 			Assign the block to the at-rule’s block.
 			Return the at-rule.
@@ -3837,13 +3837,13 @@ <h4 class="heading settled heading" data-level=5.4.3 id=consume-a-qualified-rule
 			This is a <a data-link-type=dfn href=#parse-error title="parse error">parse error</a>.
 			Return nothing.
 
-		<dt>&lt;&lt;{-token&gt;&gt;
+		<dt><a href=#tokendef-open-curly>&lt;{-token&gt;</a>
 		<dd>
 			<a data-link-type=dfn href=#consume-a-simple-block0 title="consume a simple block">Consume a simple block</a>
 			and assign it to the qualified rule’s block.
 			Return the qualified rule.
 
-		<dt><a data-link-type=dfn href=#simple-block title="simple block">simple block</a> with an associated token of &lt;&lt;{-token&gt;&gt;
+		<dt><a data-link-type=dfn href=#simple-block title="simple block">simple block</a> with an associated token of <a href=#tokendef-open-curly>&lt;{-token&gt;</a>
 		<dd>
 			Assign the block to the qualified rule’s block.
 			Return the qualified rule.
@@ -3948,7 +3948,7 @@ <h4 class="heading settled heading" data-level=5.4.6 id=consume-a-component-valu
 <p>	<a data-link-type=dfn href=#consume-the-next-input-token title="consume the next input token">Consume the next input token</a>.
 
 <p>	If the <a data-link-type=dfn href=#current-input-token title="current input token">current input token</a>
-	is a &lt;&lt;{-token&gt;&gt;, &lt;&lt;[-token&gt;&gt;, or &lt;&lt;(-token&gt;&gt;,
+	is a <a href=#tokendef-open-curly>&lt;{-token&gt;</a>, <a href=#tokendef-open-square>&lt;[-token&gt;</a>, or <a href=#tokendef-open-paren>&lt;(-token&gt;</a>,
 	<a data-link-type=dfn href=#consume-a-simple-block0 title="consume a simple block">consume a simple block</a>
 	and return it.
 
@@ -3966,7 +3966,7 @@ <h4 class="heading settled heading" data-level=5.4.7 id=consume-a-simple-block><
 <p>	To <dfn data-dfn-type=dfn data-noexport="" id=consume-a-simple-block0>consume a simple block<a class=self-link href=#consume-a-simple-block0></a></dfn>:
 
 <p>	The <dfn data-dfn-type=dfn data-noexport="" id=ending-token>ending token<a class=self-link href=#ending-token></a></dfn> is the mirror variant of the <a data-link-type=dfn href=#current-input-token title="current input token">current input token</a>.
-	(E.g. if it was called with &lt;&lt;[-token&gt;&gt;, the <a data-link-type=dfn href=#ending-token title="ending token">ending token</a> is &lt;&lt;]-token&gt;&gt;.)
+	(E.g. if it was called with <a href=#tokendef-open-square>&lt;[-token&gt;</a>, the <a data-link-type=dfn href=#ending-token title="ending token">ending token</a> is <a href=#tokendef-close-square>&lt;]-token&gt;</a>.)
 
 <p>	Create a <a data-link-type=dfn href=#simple-block title="simple block">simple block</a> with its associated token set to the <a data-link-type=dfn href=#current-input-token title="current input token">current input token</a>
 	and with a value with is initially an empty list.
@@ -3999,7 +3999,7 @@ <h4 class="heading settled heading" data-level=5.4.8 id=consume-a-function><span
 
 	<dl>
 		<dt><a class="production css-code" data-link-type=type href=#typedef-eof-token title="<eof-token>">&lt;EOF-token&gt;</a>
-		<dt>&lt;&lt;)-token&gt;&gt;
+		<dt><a href=#tokendef-close-paren>&lt;)-token&gt;</a>
 		<dd>
 			Return the function.
 
@@ -4228,7 +4228,7 @@ <h2 class="heading settled heading" data-level=7 id=rule-defs><span class=secno>
 		<li><a class="production css-code" data-link-type=type href=#typedef-ident-token title="<ident-token>">&lt;ident-token&gt;</a>s (such as <span class=css data-link-type=maybe title=auto>auto</span>, <span class=css data-link-type=maybe title=disc>disc</span>, etc), which are simply written as their value.
 		<li><a class="production css-code" data-link-type=type href=#typedef-at-keyword-token title="<at-keyword-token>">&lt;at-keyword-token&gt;</a>s, which are written as an @ character followed by the token’s value, like "@media".
 		<li><a class="production css-code" data-link-type=type href=#typedef-function-token title="<function-token>">&lt;function-token&gt;</a>s, which are written as the function name followed by a ( character, like "translate(".
-		<li>The <a class="production css-code" data-link-type=type href=#typedef-colon-token title="<colon-token>">&lt;colon-token&gt;</a> (written as <code>:</code>), <a class="production css-code" data-link-type=type href=#typedef-comma-token title="<comma-token>">&lt;comma-token&gt;</a> (written as <code>,</code>), <a class="production css-code" data-link-type=type href=#typedef-semicolon-token title="<semicolon-token>">&lt;semicolon-token&gt;</a> (written as <code>;</code>), &lt;&lt;(-token&gt;&gt;, &lt;&lt;)-token&gt;&gt;, &lt;&lt;{-token&gt;&gt;, and &lt;&lt;}-token&gt;&gt;s.
+		<li>The <a class="production css-code" data-link-type=type href=#typedef-colon-token title="<colon-token>">&lt;colon-token&gt;</a> (written as <code>:</code>), <a class="production css-code" data-link-type=type href=#typedef-comma-token title="<comma-token>">&lt;comma-token&gt;</a> (written as <code>,</code>), <a class="production css-code" data-link-type=type href=#typedef-semicolon-token title="<semicolon-token>">&lt;semicolon-token&gt;</a> (written as <code>;</code>), <a href=#tokendef-open-paren>&lt;(-token&gt;</a>, <a href=#tokendef-close-paren>&lt;)-token&gt;</a>, <a href=#tokendef-open-curly>&lt;{-token&gt;</a>, and <a href=#tokendef-close-curly>&lt;}-token&gt;</a>s.
 	</ul>
 
 <p>	Tokens match if their value is an <a data-link-type=dfn href=#ascii-case-insensitive title="ascii case-insensitive">ASCII case-insensitive</a> match
@@ -4242,7 +4242,7 @@ <h2 class="heading settled heading" data-level=7 id=rule-defs><span class=secno>
 
 	<a class="production css-code" data-link-type=type href=#typedef-delim-token title="<delim-token>">&lt;delim-token&gt;</a>s are written with their value enclosed in single quotes.
 	For example, a <a class="production css-code" data-link-type=type href=#typedef-delim-token title="<delim-token>">&lt;delim-token&gt;</a> containing the "+" <a data-link-type=dfn href=#code-point title="code point">code point</a> is written as <code>'+'</code>.
-	Similarly, the &lt;&lt;[-token&gt;&gt; and &lt;&lt;]-token&gt;&gt;s must be written in single quotes,
+	Similarly, the <a href=#tokendef-open-square>&lt;[-token&gt;</a> and <a href=#tokendef-close-square>&lt;]-token&gt;</a>s must be written in single quotes,
 	as they’re used by the syntax of the grammar itself to group clauses.
 	<a class="production css-code" data-link-type=type href=#typedef-whitespace-token title="<whitespace-token>">&lt;whitespace-token&gt;</a> is never indicated in the grammar;
 	<a class="production css-code" data-link-type=type href=#typedef-whitespace-token title="<whitespace-token>">&lt;whitespace-token&gt;</a>s are allowed before, after, and between any two tokens,
@@ -4469,7 +4469,7 @@ <h2 class="heading settled heading" data-level=9 id=serialization><span class=se
 			a <a class="production css-code" data-link-type=type href=#typedef-number-token title="<number-token>">&lt;number-token&gt;</a>, <a class="production css-code" data-link-type=type href=#typedef-ident-token title="<ident-token>">&lt;ident-token&gt;</a>, or <a class="production css-code" data-link-type=type href=#typedef-dimension-token title="<dimension-token>">&lt;dimension-token&gt;</a> followed by a <a class="production css-code" data-link-type=type href=#typedef-percentage-token title="<percentage-token>">&lt;percentage-token&gt;</a>, <a class="production css-code" data-link-type=type href=#typedef-unicode-range-token title="<unicode-range-token>">&lt;unicode-range-token&gt;</a>, <a class="production css-code" data-link-type=type href=#typedef-url-token title="<url-token>">&lt;url-token&gt;</a>, or <a class="production css-code" data-link-type=type href=#typedef-function-token title="<function-token>">&lt;function-token&gt;</a>;
 
 		<li>
-			an <a class="production css-code" data-link-type=type href=#typedef-ident-token title="<ident-token>">&lt;ident-token&gt;</a> followed by a &lt;&lt;(-token&gt;&gt;;
+			an <a class="production css-code" data-link-type=type href=#typedef-ident-token title="<ident-token>">&lt;ident-token&gt;</a> followed by a <a href=#tokendef-open-paren>&lt;(-token&gt;</a>;
 
 		<li>
 			a <a class="production css-code" data-link-type=type href=#typedef-delim-token title="<delim-token>">&lt;delim-token&gt;</a> containing "#" or "@" followed by any token except <a class="production css-code" data-link-type=type href=#typedef-whitespace-token title="<whitespace-token>">&lt;whitespace-token&gt;</a>;
@@ -4643,7 +4643,7 @@ <h3 class="heading settled heading" data-level=10.2 id=changes-css21><span class
 
 		<li>
 			The handling of some miscellanous "special" tokens
-			(like an unmatched &lt;&lt;}-token&gt;&gt;)
+			(like an unmatched <a href=#tokendef-close-curly>&lt;}-token&gt;</a>)
 			showing up in various places in the grammar
 			has been specified with some reasonable behavior shown by at least one browser.
 			Previously, stylesheets with those tokens in those places just didn’t match the stylesheet grammar at all,