Skip to content

Commit 81ee034

Browse files
jyasskindomenic
authored andcommitted
Editorial: export more definitions for Bikeshed-using specs
In particular, this takes care of the terms that Bluetooth and Permissions use.
1 parent 7d25c4c commit 81ee034

File tree

1 file changed

+25
-23
lines changed

1 file changed

+25
-23
lines changed

source

Lines changed: 25 additions & 23 deletions
Original file line numberDiff line numberDiff line change
@@ -2015,13 +2015,13 @@ a.setAttribute('href', 'http://example.com/'); // change the content attribute d
20152015

20162016
<p>When an algorithm B says to return to another algorithm A, it implies that A called B. Upon
20172017
returning to A, the implementation must continue from where it left off in calling B. Some
2018-
algorithms run <dfn>in parallel</dfn>; this means that the algorithm's subsequent steps are to be
2019-
run, one after another, at the same time as other logic in the specification (e.g. at the same
2020-
time as the <span>event loop</span>). This specification does not define the precise mechanism by
2021-
which this is achieved, be it time-sharing cooperative multitasking, fibers, threads, processes,
2022-
using different hyperthreads, cores, CPUs, machines, etc. By contrast, an operation that is to run
2023-
<dfn>immediately</dfn> must interrupt the currently running task, run itself, and then resume the
2024-
previously running task.</p>
2018+
algorithms run <dfn data-export="">in parallel</dfn>; this means that the algorithm's subsequent
2019+
steps are to be run, one after another, at the same time as other logic in the specification (e.g.
2020+
at the same time as the <span>event loop</span>). This specification does not define the precise
2021+
mechanism by which this is achieved, be it time-sharing cooperative multitasking, fibers, threads,
2022+
processes, using different hyperthreads, cores, CPUs, machines, etc. By contrast, an operation
2023+
that is to run <dfn>immediately</dfn> must interrupt the currently running task, run itself, and
2024+
then resume the previously running task.</p>
20252025

20262026
</div>
20272027

@@ -28618,8 +28618,8 @@ interface <dfn>HTMLIFrameElement</dfn> : <span>HTMLElement</span> {
2861828618

2861928619
<div w-nodev>
2862028620
<p id="fullscreen-logic">To determine whether a <code>Document</code> object <var>document</var>
28621-
is <dfn>allowed to use</dfn> the feature indicated by attribute name <var>allowattribute</var>,
28622-
run these steps:</p>
28621+
is <dfn data-export="">allowed to use</dfn> the feature indicated by attribute name
28622+
<var>allowattribute</var>, run these steps:</p>
2862328623

2862428624
<ol>
2862528625
<li><p>If <var>document</var> has no <span data-x="concept-document-bc">browsing context</span>,
@@ -72266,8 +72266,8 @@ END:VCARD</pre>
7226672266
refer to the <code data-x="event-click">click</code> event that was fired by the steps above
7226772267
leading up to this point.</p>
7226872268

72269-
<p id="allowed-to-show-a-popup">An algorithm is <dfn>triggered by user activation</dfn> if any of
72270-
the following conditions is true:</p>
72269+
<p id="allowed-to-show-a-popup">An algorithm is <dfn data-export="">triggered by user
72270+
activation</dfn> if any of the following conditions is true:</p>
7227172271

7227272272
<ul>
7227372273
<li><p>The <span data-x="concept-task">task</span> in which the algorithm is running is currently
@@ -81711,9 +81711,9 @@ State: &lt;OUTPUT NAME=I>1&lt;/OUTPUT> &lt;INPUT VALUE="Increment" TYPE=BUTTON O
8171181711
<!-- NAVIGATE <dfn>navigate</dfn> -->
8171281712
<!-- For places that _call_ this, as opposed to just referring to
8171381713
it, search for "DONAV" -->
81714-
<p>To <dfn>navigate</dfn> a browsing context <var>browsingContext</var> to a resource
81715-
<var>resource</var>, optionally with an <dfn id="exceptions-enabled"><var>exceptions enabled
81716-
flag</var></dfn>, the user agent must run these steps:</p>
81714+
<p>To <dfn data-export="">navigate</dfn> a browsing context <var>browsingContext</var> to a
81715+
resource <var>resource</var>, optionally with an <dfn id="exceptions-enabled"><var>exceptions
81716+
enabled flag</var></dfn>, the user agent must run these steps:</p>
8171781717

8171881718
<ol>
8171981719
<li><p>If <var>resource</var> is a <span>URL</span>, then set <var>resource</var> to a new <span
@@ -88178,8 +88178,9 @@ dictionary <dfn>PromiseRejectionEventInit</dfn> : <span>EventInit</span> {
8817888178
<span data-x="concept-task">task</span>'s associated <code>Document</code> or <a
8817988179
href="#workers">worker</a>.</p>
8818088180

88181-
<p>When a user agent is to <dfn>queue a task</dfn>, it must add the given task to one of the <span
88182-
data-x="task queue">task queues</span> of the relevant <span>event loop</span>.</p>
88181+
<p>When a user agent is to <dfn data-export="">queue a task</dfn>, it must add the given task to
88182+
one of the <span data-x="task queue">task queues</span> of the relevant <span>event
88183+
loop</span>.</p>
8818388184

8818488185
<p>Each <span data-x="concept-task">task</span> is defined as coming from a specific <dfn>task
8818588186
source</dfn>. All the tasks from one particular <span>task source</span> and destined to a
@@ -88393,8 +88394,9 @@ dictionary <dfn>PromiseRejectionEventInit</dfn> : <span>EventInit</span> {
8839388394
source</span> used. Normally, the <span>task source</span> of a <span>microtask</span> is
8839488395
irrelevant.</p>
8839588396

88396-
<p>When a user agent is to <dfn>perform a microtask checkpoint</dfn>, if the <span>performing a
88397-
microtask checkpoint</span> flag is false, then the user agent must run the following steps:</p>
88397+
<p>When a user agent is to <dfn data-export="">perform a microtask checkpoint</dfn>, if the
88398+
<span>performing a microtask checkpoint</span> flag is false, then the user agent must run the
88399+
following steps:</p>
8839888400

8839988401
<ol>
8840088402

@@ -88627,8 +88629,8 @@ dictionary <dfn>PromiseRejectionEventInit</dfn> : <span>EventInit</span> {
8862788629

8862888630
<!--test: <a href="http://software.hixie.ch/utilities/js/live-dom-viewer/?%3C!DOCTYPE%20html%3E%0A...%3Cscript%3E%0Aw(a%3Ddocument.implementation.createDocument(null%2C%20null%2C%20null))%3B%0Aw(a.appendChild(a.createElementNS('http%3A%2F%2Fwww.w3.org%2F1999%2Fxhtml'%2C%20'html')))%3B%0Aw(b%3Da.firstChild.appendChild(a.createElementNS('http%3A%2F%2Fwww.w3.org%2F1999%2Fxhtml'%2C%20'body')))%3B%0Aw(b.test%20%3D%20w)%3B%0Aw(b.setAttribute('onclick'%2C%20'test(%22fire%3A%20%22%20%2B%20event)'))%3B%0Aw(b.onclick)%3B%0Aw(e%3Da.createEvent('Event'))%3B%0Aw(e.initEvent('click'%2C%20false%2C%20false))%3B%0Aw(b.dispatchEvent(e))%3B%0A%3C%2Fscript%3E">test</a>-->
8862988631

88630-
<p>Many objects can have <dfn>event handlers</dfn> specified. These act as non-capture event
88631-
listeners for the object on which they are specified. <ref spec=DOM></p>
88632+
<p>Many objects can have <dfn data-export="">event handlers</dfn> specified. These act as
88633+
non-capture event listeners for the object on which they are specified. <ref spec=DOM></p>
8863288634

8863388635
<p>An <span data-x="event handlers">event handler</span> has a name, which always starts with
8863488636
"<code data-x="">on</code>" and is followed by the name of the event for which it is intended.</p>
@@ -88717,9 +88719,9 @@ dictionary <dfn>PromiseRejectionEventInit</dfn> : <span>EventInit</span> {
8871788719
or object <var>T</var> implementing the <code>EventTarget</code> interface is first set
8871888720
to a non-null value, the user agent must append an <span data-x="concept-event-listener">event
8871988721
listener</span> to the list of <span data-x="concept-event-listener">event listeners</span>
88720-
associated with <var>T</var> with <b>type</b> set to the <dfn>event handler event type</dfn>
88721-
corresponding to <var>H</var> and <b>callback</b> set to <span>the event handler processing
88722-
algorithm</span> defined below. <ref spec=DOM></p>
88722+
associated with <var>T</var> with <b>type</b> set to the <dfn data-export="">event handler event
88723+
type</dfn> corresponding to <var>H</var> and <b>callback</b> set to <span>the event handler
88724+
processing algorithm</span> defined below. <ref spec=DOM></p>
8872388725

8872488726
<p class="note">The <b>callback</b> is emphatically <em>not</em> the <span data-x="event
8872588727
handlers">event handler</span> itself. Every event handler ends up registering the same

0 commit comments

Comments
 (0)