Skip to content

Commit dc04ccd

Browse files
committed
Add conformance section, rename tokens in grammar to be mroe clear
1 parent 6a8e255 commit dc04ccd

2 files changed

Lines changed: 88 additions & 11 deletions

File tree

css-style-attr/Overview.html

Lines changed: 53 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -130,11 +130,15 @@ <h2 class="no-num no-toc" id=contents>Table of contents</h2>
130130

131131
<li><a href="#grammar"><span class=secno>3. </span>Grammar</a>
132132

133-
<li><a href="#cascading"><span class=secno>4. </span>Cascading order</a>
133+
<li><a href="#cascading"><span class=secno>4. </span>Cascading</a>
134134

135-
<li><a href="#ack"><span class=secno>5. </span>Acknowledgments</a>
135+
<li><a href="#interpret"><span class=secno>5. </span>Interpretation</a>
136136

137-
<li><a href="#references"><span class=secno>6. </span>References </a>
137+
<li><a href="#conformance"><span class=secno>6. </span>Conformance</a>
138+
139+
<li><a href="#ack"><span class=secno>7. </span>Acknowledgments</a>
140+
141+
<li><a href="#references"><span class=secno>8. </span>References </a>
138142
<ul class=toc>
139143
<li class=no-num><a href="#normative-references">Normative
140144
references</a>
@@ -180,10 +184,10 @@ <h2 id=grammar><span class=secno>3. </span>Grammar</h2>
180184

181185
<pre>
182186
inline-stylesheet
183-
: S* declaration-block
187+
: S* declaration-list
184188
;
185189

186-
declaration-block
190+
declaration-list
187191
: declaration [ ';' S* declaration ]*
188192
;
189193
</pre>
@@ -193,20 +197,52 @@ <h2 id=grammar><span class=secno>3. </span>Grammar</h2>
193197
rel=biblioentry>[CSS21]<!--{{!CSS21}}--></a> for the definition of the
194198
symbols not defined here.
195199

196-
<h2 id=cascading><span class=secno>4. </span>Cascading order</h2>
200+
<h2 id=cascading><span class=secno>4. </span>Cascading</h2>
197201

198202
<p>The declarations in a style attribute apply to the element to which the
199203
attribute belongs. CSS2.1 <a
200204
href="/TR/CSS21/cascade.html#specificity">defines</a> how style sheets and
201205
"style" attributes are cascaded together. <a href="#CSS21"
202206
rel=biblioentry>[CSS21]<!--{{!CSS21}}--></a>
203207

204-
<h2 id=ack><span class=secno>5. </span>Acknowledgments</h2>
208+
<h2 id=interpret><span class=secno>5. </span>Interpretation</h2>
209+
210+
<p>Aside from the differences in cascading, the declarations in a style
211+
attribute must be interpreted exactly as if they were given in a style
212+
rule that selected the associated element in a CSS style sheet associated
213+
with the document.
214+
215+
<h2 id=conformance><span class=secno>6. </span>Conformance</h2>
216+
217+
<p>The conformance requirements are expressed with a combination of
218+
descriptive assertions and RFC 2119 terminology. The key words "MUST",
219+
"MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", "SHOULD", "SHOULD NOT",
220+
"RECOMMENDED", "MAY", and "OPTIONAL" in the normative parts of this
221+
document are to be interpreted as described in RFC 2119. However, for
222+
readability, these words do not appear in all uppercase letters in this
223+
specification. All of the text of this specification is normative except
224+
sections explicitly marked as non-normative, examples, and notes. <a
225+
href="#RFC2119" rel=biblioentry>[RFC2119]<!--{{!RFC2119}}--></a>
226+
227+
<p>Examples in this specification are introduced with the words "for
228+
example" or are set apart from the normative text with
229+
<code>class="example"</code>, like this:
230+
231+
<div class=example>
232+
<p>This is an example of an informative example.</p>
233+
</div>
234+
235+
<p>Informative notes begin with the word "Note" and are set apart from the
236+
normative text with <code>class="note"</code>, like this:
237+
238+
<p class=note>Note, this is an informative note.
239+
240+
<h2 id=ack><span class=secno>7. </span>Acknowledgments</h2>
205241

206242
<p>Thanks to feedback from Daniel Glazman, Ian Hickson, Eric A. Meyer,
207243
Bj&ouml;rn H&ouml;hrmann.
208244

209-
<h2 id=references><span class=secno>6. </span>References</h2>
245+
<h2 id=references><span class=secno>8. </span>References</h2>
210246

211247
<h3 class=no-num id=normative-references>Normative references</h3>
212248
<!--begin-normative-->
@@ -225,6 +261,15 @@ <h3 class=no-num id=normative-references>Normative references</h3>
225261
href="http://www.w3.org/TR/2009/CR-CSS2-20090908">http://www.w3.org/TR/2009/CR-CSS2-20090908</a>
226262
</dd>
227263
<!---->
264+
265+
<dt id=RFC2119>[RFC2119]
266+
267+
<dd>S. Bradner. <a href="http://www.ietf.org/rfc/rfc2119.txt"><cite>Key
268+
words for use in RFCs to Indicate Requirement Levels.</cite></a> Internet
269+
RFC 2119. URL: <a
270+
href="http://www.ietf.org/rfc/rfc2119.txt">http://www.ietf.org/rfc/rfc2119.txt</a>
271+
</dd>
272+
<!---->
228273
</dl>
229274
<!--end-normative-->
230275

css-style-attr/Overview.src.html

Lines changed: 35 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -82,10 +82,10 @@ <h2 id="grammar">Grammar</h2>
8282

8383
<pre>
8484
inline-stylesheet
85-
: S* declaration-block
85+
: S* declaration-list
8686
;
8787

88-
declaration-block
88+
declaration-list
8989
: declaration [ ';' S* declaration ]*
9090
;
9191
</pre>
@@ -94,12 +94,44 @@ <h2 id="grammar">Grammar</h2>
9494
of the CSS2.1 specification</a> [[!CSS21]] for the definition of the symbols
9595
not defined here.
9696

97-
<h2 id="cascading">Cascading order</h2>
97+
<h2 id="cascading">Cascading</h2>
9898

9999
<p>The declarations in a style attribute apply to the element to which
100100
the attribute belongs. CSS2.1 <a href="/TR/CSS21/cascade.html#specificity">defines</a>
101101
how style sheets and "style" attributes are cascaded together. [[!CSS21]]
102102

103+
<h2 id="interpret">Interpretation</h2>
104+
105+
<p>Aside from the differences in cascading, the declarations in a style
106+
attribute must be interpreted exactly as if they were given in a style
107+
rule that selected the associated element in a CSS style sheet associated
108+
with the document.
109+
110+
<h2 id="conformance">Conformance</h2>
111+
112+
<p>The conformance requirements are expressed with a combination of
113+
descriptive assertions and RFC 2119 terminology. The key words "MUST",
114+
"MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", "SHOULD", "SHOULD NOT",
115+
"RECOMMENDED", "MAY", and "OPTIONAL" in the normative parts of this
116+
document are to be interpreted as described in RFC 2119.
117+
However, for readability, these words do not appear in all uppercase
118+
letters in this specification. All of the text of this specification is
119+
normative except sections explicitly marked as non-normative, examples,
120+
and notes. [[!RFC2119]]</p>
121+
122+
<p>Examples in this specification are introduced with the words "for example"
123+
or are set apart from the normative text with <code>class="example"</code>,
124+
like this:
125+
126+
<div class="example">
127+
<p>This is an example of an informative example.</p>
128+
</div>
129+
130+
<p>Informative notes begin with the word "Note" and are set apart from the
131+
normative text with <code>class="note"</code>, like this:
132+
133+
<p class="note">Note, this is an informative note.</p>
134+
103135
<h2 id="ack">Acknowledgments</h2>
104136

105137
<p>Thanks to feedback from Daniel Glazman, Ian Hickson, Eric A. Meyer,

0 commit comments

Comments
 (0)