Skip to content

Commit b8f34ea

Browse files
committed
[css3-syntax] Fiddle with the intro fluff text.
1 parent 2f88c92 commit b8f34ea

2 files changed

Lines changed: 24 additions & 26 deletions

File tree

css3-syntax/Overview.html

Lines changed: 21 additions & 23 deletions
Original file line numberDiff line numberDiff line change
@@ -415,17 +415,17 @@ <h2 id=syntax-description><span class=secno>2. </span> Description of CSS's
415415

416416
<p><em>This section is not normative.</em>
417417

418-
<p> A CSS document is a series of <a href="#rule"><i>rules</i></a>, which
419-
apply CSS properties to elements in the source document, and <a
420-
href="#at-rule"><i>at-rules</i></a>, which define special processing rules
421-
or values for the CSS document.
422-
423-
<p> A <dfn id=rule>rule</dfn> starts with a selector (defined by the <a
424-
href="http://www.w3.org/TR/selectors/">Selectors specification</a>), then
425-
has a {}-wrapped block containing a sequence of declarations. The selector
426-
specifies which elements the declarations will apply to. Each declaration
427-
has a property name, followed by a colon and the property value, and
428-
finished with a semicolon.
418+
<p> A CSS document is a series of <a href="#style-rule0"><i>style
419+
rules</i></a>, which apply CSS properties to elements in the source
420+
document, and <a href="#at-rule"><i>at-rules</i></a>, which define special
421+
processing rules or values for the CSS document.
422+
423+
<p> A <dfn id=style-rule>style rule</dfn> starts with a selector (defined
424+
by the <a href="http://www.w3.org/TR/selectors/">Selectors
425+
specification</a>), then has a {}-wrapped block containing a sequence of
426+
declarations. The selector specifies which elements the declarations will
427+
apply to. Each declaration has a property name, followed by a colon and
428+
the property value, and finished with a semicolon.
429429

430430
<div class=example>
431431
<p> A typical rule might look something like this:
@@ -454,11 +454,10 @@ <h2 id=syntax-description><span class=secno>2. </span> Description of CSS's
454454
simple statements, with their name followed by more CSS values to specify
455455
their behavior, and finally ended by a semicolon. Others are blocks; they
456456
can have CSS values following their name, but they end with a {}-wrapped
457-
block, similar to a <a href="#rule"><i>rule</i></a>. Even the contents of
458-
these blocks are specific to the given <a
459-
href="#at-rule"><i>at-rule</i></a>: sometimes they contain a sequence of
460-
declarations, like a <a href="#rule"><i>rule</i></a>; other times, they
461-
may contain additional blocks, or at-rules, or other structures
457+
block, similar to a <i>rule</i>. Even the contents of these blocks are
458+
specific to the given <a href="#at-rule"><i>at-rule</i></a>: sometimes
459+
they contain a sequence of declarations, like a <i>rule</i>; other times,
460+
they may contain additional blocks, or at-rules, or other structures
462461
altogether.
463462

464463
<div class=example>
@@ -482,8 +481,8 @@ <h2 id=syntax-description><span class=secno>2. </span> Description of CSS's
482481
href="#at-rule"><i>at-rule</i></a> consists of an optional page selector
483482
(the ":left" pseudoclass), followed by a block of properties that apply
484483
to the page when printed. In this way, it's very similar to a normal <a
485-
href="#rule"><i>rule</i></a>, except that its properties don't apply to
486-
any "element", but rather the page itself.
484+
href="#style-rule0"><i>style rule</i></a>, except that its properties
485+
don't apply to any "element", but rather the page itself.
487486

488487
<pre>
489488
@media print {
@@ -2717,7 +2716,7 @@ <h2 id=parsing><span class=secno>5. </span> Parsing</h2>
27172716
values, and a value consisting of a list of at-rules, style rules, or
27182717
declarations.
27192718

2720-
<dt><dfn id=style-rule>style rule</dfn>
2719+
<dt><dfn id=style-rule0>style rule</dfn>
27212720

27222721
<dd> A style rule has a selector consisting of a list of component values,
27232722
and a value consisting of a list of at-rules or declarations.
@@ -3820,15 +3819,15 @@ <h3 id=parse-a-list-of-declarations><span class=secno>6.3. </span> <dfn
38203819
<li> Initialize the <a href="#stack-of-open-rules"><i>stack of open
38213820
rules</i></a> by pushing a new <a
38223821
href="#stylesheet"><i>stylesheet</i></a> onto it, and then pushing a new
3823-
<a href="#style-rule"><i>style rule</i></a> onto it with a selector set
3822+
<a href="#style-rule0"><i>style rule</i></a> onto it with a selector set
38243823
to the empty string and an initially empty value.
38253824

38263825
<li> Invoke the <a href="#parser-state-machine">parser</a>, with the <a
38273826
href="#only-declarations"><i>only declarations</i></a> flag set, starting
38283827
in the <a href="#declaration-block-mode0"><i>declaration-block
38293828
mode</i></a>.
38303829

3831-
<li> Return the value of the <a href="#style-rule"><i>style rule</i></a>
3830+
<li> Return the value of the <a href="#style-rule0"><i>style rule</i></a>
38323831
in the value of the <a href="#stylesheet"><i>stylesheet</i></a> it
38333832
returns.
38343833
</ol>
@@ -4308,8 +4307,6 @@ <h2 class=no-num id=index> Index</h2>
43084307
<li>renderer, <a href="#renderer"
43094308
title="section 8.2."><strong>8.2.</strong></a>
43104309

4311-
<li>rule, <a href="#rule" title="section 2."><strong>2.</strong></a>
4312-
43134310
<li>Rule-block mode, <a href="#rule-block-mode0"
43144311
title="section 5.3.3."><strong>5.3.3.</strong></a>
43154312

@@ -4339,6 +4336,7 @@ <h2 class=no-num id=index> Index</h2>
43394336
title="section 4.6."><strong>4.6.</strong></a>
43404337

43414338
<li>style rule, <a href="#style-rule"
4339+
title="section 2."><strong>2.</strong></a>, <a href="#style-rule0"
43424340
title="section 5."><strong>5.</strong></a>
43434341

43444342
<li>stylesheet, <a href="#stylesheet"

css3-syntax/Overview.src.html

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -104,13 +104,13 @@ <h2 id='syntax-description'>
104104
<p><em>This section is not normative.</em>
105105

106106
<p>
107-
A CSS document is a series of <i>rules</i>,
107+
A CSS document is a series of <i>style rules</i>,
108108
which apply CSS properties to elements in the source document,
109109
and <i>at-rules</i>,
110110
which define special processing rules or values for the CSS document.
111111

112112
<p>
113-
A <dfn>rule</dfn> starts with a selector
113+
A <dfn>style rule</dfn> starts with a selector
114114
(defined by the <a href="http://www.w3.org/TR/selectors/">Selectors specification</a>),
115115
then has a {}-wrapped block containing a sequence of declarations.
116116
The selector specifies which elements the declarations will apply to.
@@ -173,7 +173,7 @@ <h2 id='syntax-description'>
173173
<p>
174174
The ''@page'' <i>at-rule</i> consists of an optional page selector (the ":left" pseudoclass),
175175
followed by a block of properties that apply to the page when printed.
176-
In this way, it's very similar to a normal <i>rule</i>,
176+
In this way, it's very similar to a normal <i>style rule</i>,
177177
except that its properties don't apply to any "element",
178178
but rather the page itself.
179179

0 commit comments

Comments
 (0)