Skip to content

Commit fc9a349

Browse files
authored
Editorial: fix various editorial issues
This makes these changes: - In Web IDL fragments, operation parameters aren't typically italicized, so remove <var> tags from the few places that have them. - Mark "this" with <span> rather than <var>. - Fix typos.
1 parent 5c729b3 commit fc9a349

File tree

1 file changed

+15
-15
lines changed

1 file changed

+15
-15
lines changed

Diff for: source

+15-15
Original file line numberDiff line numberDiff line change
@@ -7488,7 +7488,7 @@ a.setAttribute('href', 'https://example.com/'); // change the content attribute
74887488
<h4>Extracting character encodings from <code>meta</code> elements</h4>
74897489

74907490
<p>The <dfn>algorithm for extracting a character encoding from a <code>meta</code> element</dfn>,
7491-
given a string <var>s</var>, is as follows. It either returns a character encoding or
7491+
given a string <var>s</var>, is as follows. It returns either a character encoding or
74927492
nothing.</p>
74937493

74947494
<ol> <!-- https://www.hixie.ch/tests/adhoc/html/parsing/encoding/all.html -->
@@ -62224,18 +62224,18 @@ interface <dfn interface>HTMLDialogElement</dfn> : <span>HTMLElement</span> {
6222462224
are:</p>
6222562225

6222662226
<ol>
62227-
<li><p>If <var>this</var> does not have an <code data-x="attr-dialog-open">open</code>
62227+
<li><p>If <span>this</span> does not have an <code data-x="attr-dialog-open">open</code>
6222862228
attribute, then return.</p></li>
6222962229

62230-
<li><p><span>Assert</span>: <var>this</var>'s <span data-x="dialog-close-watcher">close
62230+
<li><p><span>Assert</span>: <span>this</span>'s <span data-x="dialog-close-watcher">close
6223162231
watcher</span> is not null.</p></li>
6223262232

6223362233
<li><p>Set <var>dialog</var>'s <span>enable close watcher for <code
6223462234
data-x="dom-dialog-requestClose">requestClose()</code></span> to true.</p></li>
6223562235

6223662236
<li><p>If <var>returnValue</var> is not given, then set it to null.</p></li>
6223762237

62238-
<li><p>Set <var>this</var>'s <span>request close return value</span> to
62238+
<li><p>Set <span>this</span>'s <span>request close return value</span> to
6223962239
<var>returnValue</var>.</p></li>
6224062240

6224162241
<li><p><span data-x="close-watcher-request-close">Request to close</span> <var>dialog</var>'s
@@ -80271,7 +80271,7 @@ dictionary <dfn dictionary>CommandEventInit</dfn> : <span>EventInit</span> {
8027180271
<p>The <dfn attribute
8027280272
for="CommandEvent"><code data-x="dom-CommandEvent-source">source</code></dfn> getter steps are to
8027380273
return the result of <span data-x="dom-retarget">retargeting</span> <code
80274-
data-x="dom-CommandEvent-source">source</code> against <var>this</var>'s <code
80274+
data-x="dom-CommandEvent-source">source</code> against <span>this</span>'s <code
8027580275
data-x="dom-Event-currentTarget">currentTarget</code>.</p>
8027680276

8027780277
<p class="XXX"><a href="https://github.com/whatwg/dom/issues/1328">DOM standard issue #1328</a>
@@ -87146,7 +87146,7 @@ dictionary <dfn dictionary>DragEventInit</dfn> : <span>MouseEventInit</span> {
8714687146

8714787147
<p>To <dfn>check popover validity</dfn> for an <span data-x="HTML elements">HTML element</span>
8714887148
<var>element</var> given a boolean <var>expectedToBeShowing</var>, a boolean
87149-
<var>throwExceptions</var>, and a <code>Document</code> or null <var>expectedDocument</var>
87149+
<var>throwExceptions</var>, and a <code>Document</code> or null <var>expectedDocument</var>,
8715087150
perform the following steps. They throw an exception or return a boolean.</p>
8715187151

8715287152
<ol>
@@ -90076,7 +90076,7 @@ dictionary <dfn dictionary>DragEventInit</dfn> : <span>MouseEventInit</span> {
9007690076
<div w-nodev>
9007790077

9007890078
<p>When the user agent is to <dfn export>parse a sandboxing directive</dfn>, given a string
90079-
<var>input</var>, a <span>sandboxing flag set</span> <var>output</var>, it must run the following
90079+
<var>input</var> and a <span>sandboxing flag set</span> <var>output</var>, it must run the following
9008090080
steps:</p>
9008190081

9008290082
<ol>
@@ -101965,7 +101965,7 @@ location.href = '#foo';</code></pre>
101965101965
<p>To <dfn>hand-off to external software</dfn> given a <span>URL</span> or <span
101966101966
data-x="concept-response">response</span> <var>resource</var>, a <span>navigable</span>
101967101967
<var>navigable</var>, a <span>sandboxing flag set</span> <var>sandboxFlags</var>, a boolean
101968-
<var>hasTransientActivation</var>, and an <span>origin</span> <var>initiatorOrigin</var> user
101968+
<var>hasTransientActivation</var>, and an <span>origin</span> <var>initiatorOrigin</var>, user
101969101969
agents should:</p>
101970101970

101971101971
<ol>
@@ -114981,7 +114981,7 @@ interface mixin <dfn interface>WindowOrWorkerGlobalScope</dfn> {
114981114981
undefined <span data-x="dom-clearInterval">clearInterval</span>(optional long id = 0);
114982114982

114983114983
// microtask queuing
114984-
undefined <span data-x="dom-queueMicrotask">queueMicrotask</span>(<span data-x="idl-VoidFunction">VoidFunction</span> <var>callback</var>);
114984+
undefined <span data-x="dom-queueMicrotask">queueMicrotask</span>(<span data-x="idl-VoidFunction">VoidFunction</span> callback);
114985114985

114986114986
// ImageBitmap
114987114987
<span data-x="idl-Promise">Promise</span>&lt;<span>ImageBitmap</span>&gt; <span data-x="dom-createImageBitmap">createImageBitmap</span>(<span>ImageBitmapSource</span> image, optional <span>ImageBitmapOptions</span> options = {});
@@ -115397,7 +115397,7 @@ document.body.appendChild(frame)</code></pre>
115397115397
Initially, the counter must be set to zero.</p>
115398115398

115399115399
<p>The <dfn>document write steps</dfn>, given a <code>Document</code> object <var>document</var>,
115400-
a list <var>text</var>, a boolean <var>lineFeed</var> and a string <var>sink</var>, are as
115400+
a list <var>text</var>, a boolean <var>lineFeed</var>, and a string <var>sink</var>, are as
115401115401
follows:</p>
115402115402

115403115403
<ol>
@@ -115574,7 +115574,7 @@ dictionary <dfn dictionary>GetHTMLOptions</dfn> {
115574115574
interface <dfn interface>DOMParser</dfn> {
115575115575
<span data-x="dom-DOMParser-constructor">constructor</span>();
115576115576

115577-
[NewObject] <code>Document</code> <span data-x="dom-DOMParser-parseFromString">parseFromString</span>((<code data-x="tt-trustedhtml">TrustedHTML</code> or DOMString) <var>string</var>, <span>DOMParserSupportedType</span> <var>type</var>);
115577+
[NewObject] <code>Document</code> <span data-x="dom-DOMParser-parseFromString">parseFromString</span>((<code data-x="tt-trustedhtml">TrustedHTML</code> or DOMString) string, <span>DOMParserSupportedType</span> type);
115578115578
};
115579115579

115580115580
enum <dfn enum>DOMParserSupportedType</dfn> {
@@ -116232,7 +116232,7 @@ enum <dfn enum>DOMParserSupportedType</dfn> {
116232116232
and attributes like <code>script</code> or <span>event handler content attributes</span>.</p>
116233116233

116234116234
<pre><code class="idl">partial interface <span id="Range-partial">Range</span> {
116235-
[<span>CEReactions</span>, NewObject] <code>DocumentFragment</code> <span data-x="dom-Range-createContextualFragment">createContextualFragment</span>((<code data-x="tt-trustedhtml">TrustedHTML</code> or DOMString) <var>string</var>);
116235+
[<span>CEReactions</span>, NewObject] <code>DocumentFragment</code> <span data-x="dom-Range-createContextualFragment">createContextualFragment</span>((<code data-x="tt-trustedhtml">TrustedHTML</code> or DOMString) string);
116236116236
};</code></pre>
116237116237

116238116238
<div w-nodev>
@@ -120631,7 +120631,7 @@ dictionary <dfn dictionary>StructuredSerializeOptions</dfn> {
120631120631
<hr>
120632120632

120633120633
<p>The <dfn>message port post message steps</dfn>, given <var>sourcePort</var>,
120634-
<var>targetPort</var>, <var>message</var> and <var>options</var> are as follows:</p>
120634+
<var>targetPort</var>, <var>message</var>, and <var>options</var> are as follows:</p>
120635120635

120636120636
<ol> <!-- a lot of this is similar or identical to the window post message steps -->
120637120637
<li><p>Let <var>transfer</var> be <var>options</var>["<code
@@ -122112,7 +122112,7 @@ interface <dfn interface>SharedWorkerGlobalScope</dfn> : <span>WorkerGlobalScope
122112122112

122113122113
<hr>
122114122114

122115-
<p>When a user agent is to <dfn export>terminate a worker</dfn> it must run the following steps
122115+
<p>When a user agent is to <dfn export>terminate a worker</dfn>, it must run the following steps
122116122116
<span>in parallel</span> with the worker's main loop (the "<span>run a worker</span>" processing
122117122117
model defined above):</p>
122118122118

@@ -130543,7 +130543,7 @@ document.body.appendChild(text);
130543130543
<hr>
130544130544

130545130545
<p>When the steps below require the user agent to <dfn>insert a comment</dfn> while processing a
130546-
comment token, optionally with an explicitly insertion position <var>position</var>, the
130546+
comment token, optionally with an explicit insertion position <var>position</var>, the
130547130547
user agent must run the following steps:</p>
130548130548

130549130549
<ol>

0 commit comments

Comments
 (0)