Skip to content

Commit 90379cd

Browse files
committed
[css-syntax] Clarify non-normative-ness of several sections and links, so the Normative References chapter is correct and minimal.
1 parent 219e2c0 commit 90379cd

File tree

1 file changed

+9
-9
lines changed

1 file changed

+9
-9
lines changed

css-syntax-3/Overview.bs

+9-9
Original file line numberDiff line numberDiff line change
@@ -399,7 +399,7 @@ The input byte stream</h3>
399399

400400
Note: [[CSSOM]] defines <a href="https://drafts.csswg.org/cssom/#requirements-on-user-agents-implementing-the-xml-stylesheet-processing-instruction">the environment encoding for <code>&lt;xml-stylesheet?></code></a>.
401401

402-
Note: [[CSS-CASCADE-3]] defines <a href="https://drafts.csswg.org/css-cascade/#at-ruledef-import">the environment encoding for <code>@import</code></a>.
402+
Note: [[CSS-CASCADE-3]] defines <a at-rule lt=@import>the environment encoding for <code>@import</code></a>.
403403

404404

405405
<h3 id="input-preprocessing">
@@ -1996,7 +1996,7 @@ Parse something according to a CSS grammar</h4>
19961996
If it is meant to be exposed outside of spec language,
19971997
the spec using the result must explicitly translate it into a well-specified representation,
19981998
such as, for example, by invoking a CSS serialization algorithm
1999-
(like "serialize as a CSS <<string>> value").
1999+
<span class=informative>(like "serialize as a CSS <<string>> value").</span>
20002000

20012001
To <dfn export lt="parse something according to a CSS grammar|parse" for=CSS>parse something according to a CSS grammar</dfn>:
20022002

@@ -2539,7 +2539,7 @@ Consume a function</h4>
25392539
The <var>An+B</var> microsyntax</h2>
25402540

25412541
Several things in CSS,
2542-
such as the '':nth-child()'' pseudoclass,
2542+
such as the <span class=informative>'':nth-child()''</span> pseudoclass,
25432543
need to indicate indexes in a list.
25442544
The <var>An+B</var> microsyntax is useful for this,
25452545
allowing an author to easily indicate single elements
@@ -2784,7 +2784,7 @@ The <code>&lt;an+b></code> type</h3>
27842784
The Unicode-Range microsyntax</h2>
27852785

27862786
Some constructs,
2787-
<span class="informative">such as the 'unicode-range' descriptor for the ''@font-face'' rule</span>,
2787+
<span class=informative>such as the 'unicode-range' descriptor for the ''@font-face'' rule,</span>
27882788
need a way to describe one or more unicode code points.
27892789
The <dfn>&lt;urange></dfn> production represents a range of one or more unicode code points.
27902790

@@ -3131,12 +3131,12 @@ Defining Arbitrary Contents: the <<declaration-value>> and <<any-value>> product
31313131
(rather than simply invalidating the construct,
31323132
as grammar mismatches tend to do).
31333133

3134-
For example, <a>custom properties</a> allow any reasonable value,
3134+
<span class=informative>For example, <a>custom properties</a> allow any reasonable value,
31353135
as they can contain arbitrary pieces of other CSS properties,
31363136
or be used for things that aren't part of existing CSS at all.
31373137
For another example, the <<general-enclosed>> production in Media Queries
31383138
defines the bounds of what future syntax MQs will allow,
3139-
and uses special logic to deal with "unknown" values.
3139+
and uses special logic to deal with "unknown" values.</span>
31403140

31413141
To aid in this, two additional productions are defined:
31423142

@@ -3179,11 +3179,11 @@ CSS stylesheets</h2>
31793179
Style rules</h3>
31803180

31813181
A <dfn export>style rule</dfn> is a <a>qualified rule</a>
3182-
that associates a <a>selector list</a> [[!SELECT]]
3182+
that associates a <a>selector list</a>
31833183
with a list of property declarations.
31843184
They are also called
31853185
<a href="https://www.w3.org/TR/CSS2/syndata.html#rule-sets">rule sets</a> in [[!CSS2]].
3186-
CSS Cascading and Inheritance [[!CSS-CASCADE-3]] defines how the declarations inside of style rules participate in the cascade.
3186+
CSS Cascading and Inheritance [[CSS-CASCADE-3]] defines how the declarations inside of style rules participate in the cascade.
31873187

31883188
The prelude of the qualified rule is [=CSS/parsed=]
31893189
as a <<selector-list>>.
@@ -3410,7 +3410,7 @@ Privacy and Security Considerations</h2>
34103410
██████ ██ ██ ██ ██ ██ ██ ██████ ████████ ██████
34113411
-->
34123412

3413-
<h2 id="changes">
3413+
<h2 id="changes" class=non-normative>
34143414
Changes</h2>
34153415

34163416
<em>This section is non-normative.</em>

0 commit comments

Comments
 (0)