Skip to content

Commit 775bbfa

Browse files
author
Simon Pieters
committed
[cssom*] Editorial: update anolis, be strict about xrefs
1 parent 41f2b02 commit 775bbfa

9 files changed

Lines changed: 1247 additions & 1156 deletions

File tree

‎cssom-values/Makefile‎

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -16,9 +16,9 @@ $(XREFS): Overview.src.html Makefile
1616
$(ANOLIS) --dump-xrefs=$@ $< /tmp/spec; $(RM) /tmp/spec
1717

1818
$(EDFILE): Overview.src.html $(XREF) Makefile
19-
$(ANOLIS) --output-encoding=utf-8 --omit-optional-tags --quote-attr-values \
20-
--w3c-compat --enable=xspecxref --enable=refs --w3c-shortname="cssom-values" \
21-
--force-html4-id --filter=".publish" $< $@; \
19+
$(ANOLIS) --output-encoding=utf-8 --omit-optional-tags --quote-attr-values --use-strict \
20+
--w3c-compat-substitutions --w3c-compat-xref-a-placement --enable=xspecxref --enable=refs --w3c-shortname="cssom-values" \
21+
--filter=".publish" $< $@; \
2222
$(SED) 's/\[/\(/g;s/\]/\)/g' <$(SRCFILE) >$(VNUFILE); \
2323
$(CURL) -F out=gnu -F content=@$(VNUFILE) http://validator.nu/; \
2424
$(RM) $(VNUFILE); \
@@ -28,9 +28,9 @@ $(EDFILE): Overview.src.html $(XREF) Makefile
2828
draft: $(EDFILE)
2929

3030
$(TRFILE): Overview.src.html $(XREF) Makefile
31-
$(ANOLIS) --output-encoding=utf-8 --omit-optional-tags --quote-attr-values \
32-
--w3c-compat --enable=xspecxref --enable=refs --w3c-shortname="cssom-values" \
33-
--force-html4-id --filter=".dontpublish" --pubdate="$(PUBDATE)" \
31+
$(ANOLIS) --output-encoding=utf-8 --omit-optional-tags --quote-attr-values --use-strict \
32+
--w3c-compat-substitutions --w3c-compat-xref-a-placement --enable=xspecxref --enable=refs --w3c-shortname="cssom-values" \
33+
--filter=".dontpublish" --pubdate="$(PUBDATE)" \
3434
--w3c-status=WD $< $@
3535

3636
publish: $(TRFILE)

‎cssom-values/Overview.html‎

Lines changed: 97 additions & 56 deletions
Large diffs are not rendered by default.

‎cssom-values/Overview.src.html‎

Lines changed: 39 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -19,7 +19,6 @@
1919
dl.switch > dt:before { content:'\21AA'; padding:0 0.5em 0 0; display:inline-block; width:1em; text-align:right; line-height:0.5em }
2020
code { color:orangered }
2121
code :link, code :visited { color:inherit }
22-
span:not(.secno) { border-bottom:solid red }
2322
.atrisk::before { position:absolute; left:30px; margin-top:-8px; width:25px; height:25px; padding:0 4px 8px; border:1px solid; content:'At risk';
2423
font-size:smaller; background:white; color:gray; border-radius:25px; text-align:center }
2524
td { vertical-align:baseline }
@@ -162,21 +161,29 @@ <h3>Dependencies</h3>
162161
<dl>
163162

164163
<dt>CSSOM</dt>
165-
<dd><p>A <span>conforming user agent</span> must support the <span>CSS Object
166-
Model</span> <span data-anolis-ref>CSSOM</span>.</p>
164+
<dd><p>A conforming user agent must support the CSS Object
165+
Model. <span data-anolis-ref>CSSOM</span></p>
167166
<p class="XXX">Narrow this dependency to specific features of CSSOM.</p>
168167
</dd>
169168

170169
</dl>
171170

172171
<h2>CSS Values</h2>
173172

173+
<h3>The <code title>CSSValue</code> Interface</h3>
174+
175+
<pre class=idl>interface <dfn>CSSValue</dfn> {
176+
<span class=XXX title>// ...</span>
177+
}</pre>
178+
174179
<h3>The <code title>CSSStyleDeclaration</code> Interface</h3>
175180

176181
<pre class="idl">partial interface <dfn>CSSStyleDeclaration</dfn> {
177182
readonly attribute <span>CSSStyleDeclarationValue</span> <span title="dom-CSSStyleDeclaration-values">values</span>;
178183
};</pre>
179184

185+
<p class=XXX><dfn title=dom-CSSStyleDeclaration-values><code>values</code></dfn>
186+
180187
<h3>The <code title>CSSStyleDeclarationValue</code> Interface</h3>
181188

182189
<pre class="idl">interface <dfn>CSSStyleDeclarationValue</dfn> {
@@ -187,7 +194,7 @@ <h3>The <code title>CSSStyleDeclarationValue</code> Interface</h3>
187194
<p class="XXX">The rough idea is that this interface exposes the full
188195
list of supported properties as well that each return a
189196
<code>CSSPropertyValue</code> object. That object can implement other
190-
objects depending on the property involved. E.g. for '<code>width</code>'
197+
objects depending on the property involved. E.g. for '<code title>width</code>'
191198
the object would implement <code>CSSLengthComponentValue</code> and
192199
<code>CSSPercentageComponentValue</code>.</p>
193200

@@ -197,6 +204,8 @@ <h3>The <code title>CSSPropertyValue</code> Interface</h3>
197204
attribute DOMString <span title="dom-CSSPropertyValue-cssText">cssText</span>;
198205
};</pre>
199206

207+
<p class=XXX><dfn title=dom-CSSPropertyValue-cssText><code>cssText</code></dfn>
208+
200209
<!--
201210
what does the CSSValue represent
202211
"map"
@@ -214,12 +223,14 @@ <h3>The <code title>CSSPropertyValueList</code> Interface</h3>
214223
readonly attribute <span>CSSValue</span>[] <span title="dom-CSSPropertyValue-list">list</span>;
215224
};</pre>
216225

226+
<p class=XXX><dfn title=dom-CSSPropertyValue-list><code>list</code></dfn>
227+
217228
<p class="XXX">Ideally this attribute just returns a mutable array.</p>
218229

219230
<h3>The <code title>CSSMapValue</code> Interface</h3>
220231

221232
<pre class="idl">[NoInterfaceObject] interface <dfn>CSSMapValue</dfn> {
222-
getter <span>CSSValue</span> (DOMString <var title>name</var>);
233+
getter <span>CSSValue</span> (DOMString <var>name</var>);
223234
};</pre>
224235
<!-- see HTML5 DOMStringMap -->
225236

@@ -232,6 +243,9 @@ <h3>The <code title>CSSComponentValue</code> Interface</h3>
232243
attribute any <span title="dom-CSSComponentValue-value">value</span>;
233244
};</pre>
234245

246+
<p class=XXX><dfn title=dom-CSSComponentValue-type><code>type</code></dfn>
247+
<p class=XXX><dfn title=dom-CSSComponentValue-value><code>value</code></dfn>
248+
235249
<p class="XXX">type returns "string", "keyword", "identifier", "color", "em", "ex", "px", "url".</p>
236250

237251
<h4>The <code title>CSSColorComponentValue</code> Interface</h4>
@@ -243,6 +257,11 @@ <h4>The <code title>CSSColorComponentValue</code> Interface</h4>
243257
attribute float <span title="dom-CSSColorComponentValue-alpha">alpha</span>;
244258
};</pre>
245259

260+
<p class=XXX><dfn title=dom-CSSColorComponentValue-red><code>red</code></dfn>
261+
<p class=XXX><dfn title=dom-CSSColorComponentValue-green><code>green</code></dfn>
262+
<p class=XXX><dfn title=dom-CSSColorComponentValue-blue><code>blue</code></dfn>
263+
<p class=XXX><dfn title=dom-CSSColorComponentValue-alpha><code>alpha</code></dfn>
264+
246265
<p class="XXX">We can make this more complex later. This will probably move into the CSS Color Level 4.</p>
247266

248267
<h4>The <code title>CSSIdentifierComponentValue</code> Interface</h4>
@@ -251,39 +270,52 @@ <h4>The <code title>CSSIdentifierComponentValue</code> Interface</h4>
251270
attribute DOMString <span title="dom-CSSStringComponentValue-identifier">identifier</span>;
252271
};</pre>
253272

273+
<p class=XXX><dfn title=dom-CSSStringComponentValue-identifier><code>identifier</code></dfn>
274+
254275
<h4>The <code title>CSSKeywordComponentValue</code> Interface</h4>
255276

256277
<pre class="idl">[NoInterfaceObject] interface <dfn>CSSKeywordComponentValue</dfn> {
257278
attribute DOMString <span title="dom-CSSStringComponentValue-keyword">keyword</span>;
258279
};</pre>
259280

281+
<p class=XXX><dfn title=dom-CSSStringComponentValue-keyword><code>keyword</code></dfn>
282+
260283
<h4>The <code title>CSSLengthComponentValue</code> Interface</h4>
261284

262285
<pre class="idl">[NoInterfaceObject] interface <dfn>CSSLengthComponentValue</dfn> {
263286
attribute float <span title="dom-CSSLengthComponentValue-em">em</span>;
264287
attribute float <span title="dom-CSSLengthComponentValue-ex">ex</span>;
265288
attribute float <span title="dom-CSSLengthComponentValue-px">px</span>;
266-
<span class="XXX">// figure out what to do with absolute lengths</span>
289+
<span class="XXX" title>// figure out what to do with absolute lengths</span>
267290
};</pre>
268291

292+
<p class=XXX><dfn title=dom-CSSLengthComponentValue-em><code>em</code></dfn>
293+
<p class=XXX><dfn title=dom-CSSLengthComponentValue-ex><code>ex</code></dfn>
294+
<p class=XXX><dfn title=dom-CSSLengthComponentValue-px><code>px</code></dfn>
295+
269296
<h4>The <code title>CSSPercentageComponentValue</code> Interface</h4>
270297

271298
<pre class="idl">[NoInterfaceObject] interface <dfn>CSSPercentageComponentValue</dfn> {
272-
attribute float <span title="dom-CSSPercentageComponentValue">percent</span>;
299+
attribute float <span title="dom-CSSPercentageComponentValue-percent">percent</span>;
273300
};</pre>
274301

302+
<p class=XXX><dfn title=dom-CSSPercentageComponentValue-percent><code>percent</code></dfn>
303+
275304
<h4>The <code title>CSSStringComponentValue</code> Interface</h4>
276305

277306
<pre class="idl">[NoInterfaceObject] interface <dfn>CSSStringComponentValue</dfn> {
278307
attribute DOMString <span title="dom-CSSStringComponentValue-string">string</span>;
279308
};</pre>
280309

310+
<p class=XXX><dfn title=dom-CSSStringComponentValue-string><code>string</code></dfn>
311+
281312
<h4>The <code title>CSSURLComponentValue</code> Interface</h4>
282313

283314
<pre class="idl">[NoInterfaceObject] interface <dfn>CSSURLComponentValue</dfn> {
284315
attribute DOMString? <span title="dom-CSSURLComponentValue-url">url</span>;
285316
};</pre>
286317

318+
<p class=XXX><dfn title=dom-CSSURLComponentValue-url><code>url</code></dfn>
287319

288320

289321
<h2 class=no-num>References</h2>

‎cssom-view/Makefile‎

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -16,9 +16,9 @@ $(XREFS): Overview.src.html Makefile
1616
$(ANOLIS) --dump-xrefs=$@ $< /tmp/spec; $(RM) /tmp/spec
1717

1818
$(EDFILE): Overview.src.html $(XREF) Makefile
19-
$(ANOLIS) --output-encoding=utf-8 --omit-optional-tags --quote-attr-values \
20-
--w3c-compat --enable=xspecxref --enable=refs --w3c-shortname="cssom-view" \
21-
--force-html4-id --filter=".publish" $< $@; \
19+
$(ANOLIS) --output-encoding=utf-8 --omit-optional-tags --quote-attr-values --use-strict \
20+
--w3c-compat-substitutions --w3c-compat-xref-a-placement --enable=xspecxref --enable=refs --w3c-shortname="cssom-view" \
21+
--filter=".publish" $< $@; \
2222
$(SED) 's/\[/\(/g;s/\]/\)/g' <$(SRCFILE) >$(VNUFILE); \
2323
$(CURL) -F out=gnu -F content=@$(VNUFILE) http://validator.nu/; \
2424
$(RM) $(VNUFILE); \
@@ -28,9 +28,9 @@ $(EDFILE): Overview.src.html $(XREF) Makefile
2828
draft: $(EDFILE)
2929

3030
$(TRFILE): Overview.src.html $(XREF) Makefile
31-
$(ANOLIS) --output-encoding=utf-8 --omit-optional-tags --quote-attr-values \
32-
--w3c-compat --enable=xspecxref --enable=refs --w3c-shortname="cssom-view" \
33-
--force-html4-id --filter=".dontpublish" --pubdate="$(PUBDATE)" \
31+
$(ANOLIS) --output-encoding=utf-8 --omit-optional-tags --quote-attr-values --use-strict \
32+
--w3c-compat-substitutions --w3c-compat-xref-a-placement --enable=xspecxref --enable=refs --w3c-shortname="cssom-view" \
33+
--filter=".dontpublish" --pubdate="$(PUBDATE)" \
3434
--w3c-status=WD $< $@
3535

3636
publish: $(TRFILE)

0 commit comments

Comments
 (0)