- From: Michael Smith via cvs-syncmail <cvsmail@w3.org>
- Date: Sat, 04 Jun 2011 01:46:50 +0000
- To: public-html-commits@w3.org
Update of /sources/public/html5/spec
In directory hutz:/tmp/cvs-serv2122
Modified Files:
common-dom-interfaces.html dnd.html infrastructure.html
interactive-elements.html offline.html sections.html spec.html
the-iframe-element.html the-map-element.html timers.html
webappapis.html
Log Message:
Update 'fire' and 'dispatch' terminology. (whatwg r6188)
[updated by splitter]
Index: infrastructure.html
===================================================================
RCS file: /sources/public/html5/spec/infrastructure.html,v
retrieving revision 1.1078
retrieving revision 1.1079
diff -u -d -r1.1078 -r1.1079
--- infrastructure.html 3 Jun 2011 19:47:03 -0000 1.1078
+++ infrastructure.html 4 Jun 2011 01:46:47 -0000 1.1079
@@ -460,9 +460,12 @@
it.</p><p>If a DOM object is said to be <dfn id="live">live</dfn>, then the
attributes and methods on that object <span class="impl">must</span>
operate on the actual underlying data, not a snapshot of the
- data.</p><p>The terms <dfn title="">fire</dfn> and <dfn title="">dispatch</dfn> are used interchangeably in the context of
- events, as in the DOM Events specifications. The term <dfn id="concept-events-trusted" title="concept-events-trusted">trusted event</dfn> is used as
- defined by the DOM Events specification. <a href="references.html#refsDOMEVENTS">[DOMEVENTS]</a></p><h4 id="plugins"><span class="secno">2.1.5 </span>Plugins</h4><p>The term <dfn id="plugin">plugin</dfn> refers to a user-agent defined set of
+ data.</p><p>In the contexts of events, the terms <dfn title="">fire</dfn> and
+ <dfn title="">dispatch</dfn> are used as defined in the DOM Core
+ specification: firing an event means to create and dispatch it, and
+ dispatching an event means to follow the steps that propagate the
+ event through the tree. The term <dfn id="concept-events-trusted" title="concept-events-trusted">trusted event</dfn> is used to refer
+ to events that have the <span>trusted flag</span> set. <a href="references.html#refsDOMCORE">[DOMCORE]</a></p><h4 id="plugins"><span class="secno">2.1.5 </span>Plugins</h4><p>The term <dfn id="plugin">plugin</dfn> refers to a user-agent defined set of
content handlers used by the user agent that can take part in the
user agent's rendering of a <code><a href="#document">Document</a></code> object, but that
neither act as <a href="browsers.html#child-browsing-context" title="child browsing context">child browsing
Index: the-map-element.html
===================================================================
RCS file: /sources/public/html5/spec/the-map-element.html,v
retrieving revision 1.45
retrieving revision 1.46
diff -u -d -r1.45 -r1.46
--- the-map-element.html 3 Jun 2011 00:48:42 -0000 1.45
+++ the-map-element.html 4 Jun 2011 01:46:48 -0000 1.46
@@ -809,12 +809,13 @@
</li>
- </ol><p>Mouse clicks on an image associated with a set of layered shapes
- per the above algorithm must be dispatched to the top-most shape
- covering the point that the pointing device indicated (if any), and
- then, must be dispatched again (with a new <code><a href="infrastructure.html#event">Event</a></code>
- object) to the image element itself. User agents may also allow
- individual <code><a href="#the-area-element">area</a></code> elements representing <a href="links.html#hyperlink" title="hyperlink">hyperlinks</a> to be selected and activated
+ </ol><p>Pointing device interaction with an image associated with a set
+ of layered shapes per the above algorithm must result in the
+ relevant user interaction events being first fired to the top-most
+ shape covering the point that the pointing device indicated (if
+ any), and then fired again (with a new <code><a href="infrastructure.html#event">Event</a></code> object) to
+ the image element itself. User agents may also allow individual
+ <code><a href="#the-area-element">area</a></code> elements representing <a href="links.html#hyperlink" title="hyperlink">hyperlinks</a> to be selected and activated
(e.g. using a keyboard); events from this are not also propagated to
the image.</p>
Index: the-iframe-element.html
===================================================================
RCS file: /sources/public/html5/spec/the-iframe-element.html,v
retrieving revision 1.63
retrieving revision 1.64
diff -u -d -r1.63 -r1.64
--- the-iframe-element.html 3 Jun 2011 01:46:37 -0000 1.63
+++ the-iframe-element.html 4 Jun 2011 01:46:48 -0000 1.64
@@ -3764,7 +3764,7 @@
even once the <a href="#ended-playback" title="ended playback">playback has
ended</a>, because there is always the chance the user will
seek back to the start. In fact, in this situation, once <a href="#ended-playback" title="ended playback">playback has ended</a>, the user agent
- will end up dispatching a <code title="event-media-stalled"><a href="#event-media-stalled">stalled</a></code> event, as described
+ will end up firing a <code title="event-media-stalled"><a href="#event-media-stalled">stalled</a></code> event, as described
earlier.</p>
</li>
@@ -7526,7 +7526,7 @@
</div><h5 id="mediaevents"><span class="secno">4.8.10.15 </span>Event summary</h5><p><i>This section is non-normative.</i></p><p>The following events fire on <a href="#media-element" title="media element">media
elements</a> as part of the processing model described above:</p><table><thead><tr><th>Event name
</th><th>Interface
- </th><th>Dispatched when...
+ </th><th>Fired when...
</th><th>Preconditions
</th></tr></thead><tbody><tr><td><dfn id="event-media-loadstart" title="event-media-loadstart"><code>loadstart</code></dfn>
@@ -7628,7 +7628,7 @@
</td><td>
</td></tr></tbody></table><p>The following events fire on <code><a href="#mediacontroller">MediaController</a></code> objects:</p><table><thead><tr><th>Event name
</th><th>Interface
- </th><th>Dispatched when...
+ </th><th>Fired when...
</th></tr></thead><tbody><tr><td><dfn id="event-mediacontroller-emptied" title="event-MediaController-emptied"><code>emptied</code></dfn>
</td><td><code><a href="infrastructure.html#event">Event</a></code>
Index: common-dom-interfaces.html
===================================================================
RCS file: /sources/public/html5/spec/common-dom-interfaces.html,v
retrieving revision 1.53
retrieving revision 1.54
diff -u -d -r1.53 -r1.54
--- common-dom-interfaces.html 3 Jun 2011 20:47:09 -0000 1.53
+++ common-dom-interfaces.html 4 Jun 2011 01:46:47 -0000 1.54
@@ -410,7 +410,7 @@
returned. If, on the other hand, it fails or returns an out of range
value, or if the attribute is absent, the default value must be
returned instead, or −1 if there is no default value. On
- setting, if the value is negative, the user agent must fire an
+ setting, if the value is negative, the user agent must throw an
<code><a href="#index_size_err">INDEX_SIZE_ERR</a></code> exception. Otherwise, the given value
must be converted to the shortest possible string representing the
number as a <a href="common-microsyntaxes.html#valid-non-negative-integer">valid non-negative integer</a> and then that
@@ -440,7 +440,7 @@
fails or returns an out of range value, or if the attribute is
absent, the default value must be returned instead, or 1 if there is
no default value. On setting, if the value is zero, the user agent
- must fire an <code><a href="#index_size_err">INDEX_SIZE_ERR</a></code> exception. Otherwise, the
+ must throw an <code><a href="#index_size_err">INDEX_SIZE_ERR</a></code> exception. Otherwise, the
given value must be converted to the shortest possible string
representing the number as a <a href="common-microsyntaxes.html#valid-non-negative-integer">valid non-negative integer</a>
and then that string must be used as the new content attribute
Index: timers.html
===================================================================
RCS file: /sources/public/html5/spec/timers.html,v
retrieving revision 1.42
retrieving revision 1.43
diff -u -d -r1.42 -r1.43
--- timers.html 3 Jun 2011 00:48:43 -0000 1.42
+++ timers.html 4 Jun 2011 01:46:48 -0000 1.43
@@ -394,7 +394,7 @@
</dd>
- </dl><p class="note">This API does not guarantee that timers will fire
+ </dl><p class="note">This API does not guarantee that timers will run
exactly on schedule. Delays due to CPU load, other tasks, etc, are
to be expected.</p><div class="impl">
Index: interactive-elements.html
===================================================================
RCS file: /sources/public/html5/spec/interactive-elements.html,v
retrieving revision 1.1038
retrieving revision 1.1039
diff -u -d -r1.1038 -r1.1039
--- interactive-elements.html 3 Jun 2011 00:48:24 -0000 1.1038
+++ interactive-elements.html 4 Jun 2011 01:46:47 -0000 1.1039
@@ -771,13 +771,13 @@
<dl class="switch"><dt>If the user requested a context menu using a pointing device</dt>
- <dd><p>The user agent must dispatch an event with the name <code title="event-contextmenu">contextmenu</code>, that bubbles and is
+ <dd><p>The user agent must fire an event with the name <code title="event-contextmenu">contextmenu</code>, that bubbles and is
cancelable, and that uses the <code><a href="infrastructure.html#mouseevent">MouseEvent</a></code> interface, at
the element for which the menu was requested. The context
information of the event must be set to the same values as the last
- <code><a href="infrastructure.html#mouseevent">MouseEvent</a></code> user interaction event that was dispatched
- as part of the gesture that that was interpreted as a request for
- the context menu.</p></dd>
+ <code><a href="infrastructure.html#mouseevent">MouseEvent</a></code> user interaction event that was fired as
+ part of the gesture that that was interpreted as a request for the
+ context menu.</p></dd>
<dt>Otherwise</dt>
Index: offline.html
===================================================================
RCS file: /sources/public/html5/spec/offline.html,v
retrieving revision 1.1033
retrieving revision 1.1034
diff -u -d -r1.1033 -r1.1034
--- offline.html 3 Jun 2011 00:48:25 -0000 1.1033
+++ offline.html 4 Jun 2011 01:46:47 -0000 1.1034
@@ -391,7 +391,7 @@
to the state of the cache update, so that the user can be notified
appropriately. The events are as follows:</p><table><thead><tr><th> Event name
</th><th> Interface
- </th><th> Dispatched when...
+ </th><th> Fired when...
</th><th> Next events
</th></tr></thead><tbody><tr><td> <dfn id="event-appcache-checking" title="event-appcache-checking"><code>checking</code></dfn>
</td><td> <code><a href="infrastructure.html#event">Event</a></code>
Index: dnd.html
===================================================================
RCS file: /sources/public/html5/spec/dnd.html,v
retrieving revision 1.62
retrieving revision 1.63
diff -u -d -r1.62 -r1.63
--- dnd.html 3 Jun 2011 00:48:17 -0000 1.62
+++ dnd.html 4 Jun 2011 01:46:47 -0000 1.63
@@ -670,7 +670,7 @@
</dd>
</dl><p><code><a href="#datatransfer">DataTransfer</a></code> objects are used during the <a href="#dndevents">drag-and-drop events</a>, and are only valid while
- those events are being dispatched.</p><div class="impl">
+ those events are being fired.</p><div class="impl">
<p>A <code><a href="#datatransfer">DataTransfer</a></code> object is associated with a
<a href="#drag-data-store">drag data store</a> while it is valid.</p>
Index: spec.html
===================================================================
RCS file: /sources/public/html5/spec/spec.html,v
retrieving revision 1.1514
retrieving revision 1.1515
diff -u -d -r1.1514 -r1.1515
--- spec.html 3 Jun 2011 23:46:46 -0000 1.1514
+++ spec.html 4 Jun 2011 01:46:48 -0000 1.1515
@@ -322,7 +322,7 @@
<h1>HTML5</h1>
<h2 class="no-num no-toc" id="a-vocabulary-and-associated-apis-for-html-and-xhtml">A vocabulary and associated APIs for HTML and XHTML</h2>
- <h2 class="no-num no-toc" id="editor-s-draft-3-june-2011">Editor's Draft 3 June 2011</h2>
+ <h2 class="no-num no-toc" id="editor-s-draft-4-june-2011">Editor's Draft 4 June 2011</h2>
<dl><dt>Latest Published Version:</dt>
<dd><a href="http://www.w3.org/TR/html5/">http://www.w3.org/TR/html5/</a></dd>
<dt>Latest Editor's Draft:</dt>
@@ -347,7 +347,7 @@
<a href="Overview.html">single page HTML</a>,
<a href="spec.html">multipage HTML</a>,
<a href="author/">web developer edition</a>.
-This is revision 1.4960.
+This is revision 1.4961.
</p>
<p class="copyright"><a href="http://www.w3.org/Consortium/Legal/ipr-notice#Copyright">Copyright</a>
© 2011 <a href="http://www.w3.org/"><abbr title="World Wide
@@ -468,7 +468,7 @@
Group</a> is the W3C working group responsible for this
specification's progress along the W3C Recommendation
track.
- This specification is the 3 June 2011 Editor's Draft.
+ This specification is the 4 June 2011 Editor's Draft.
</p><!-- UNDER NO CIRCUMSTANCES IS THE PRECEDING PARAGRAPH TO BE REMOVED OR EDITED WITHOUT TALKING TO IAN FIRST --><p>Work on this specification is also done at the <a href="http://www.whatwg.org/">WHATWG</a>. The W3C HTML working group
actively pursues convergence with the WHATWG, as required by the <a href="http://www.w3.org/2007/03/HTML-WG-charter">W3C HTML working
group charter</a>.</p><!-- UNDER NO CIRCUMSTANCES IS THE FOLLOWING PARAGRAPH TO BE REMOVED OR EDITED WITHOUT TALKING TO IAN FIRST --><p>This document was produced by a group operating under the <a href="http://www.w3.org/Consortium/Patent-Policy-20040205/">5
Index: sections.html
===================================================================
RCS file: /sources/public/html5/spec/sections.html,v
retrieving revision 1.46
retrieving revision 1.47
diff -u -d -r1.46 -r1.47
--- sections.html 3 Jun 2011 00:48:40 -0000 1.46
+++ sections.html 4 Jun 2011 01:46:47 -0000 1.47
@@ -404,19 +404,20 @@
handlers</a> of the <code><a href="browsers.html#window">Window</a></code> object, exposed on the
<code><a href="#the-body-element">body</a></code> element, shadow the generic <a href="webappapis.html#event-handlers">event
handlers</a> with the same names normally supported by <a href="infrastructure.html#html-elements">HTML
- elements</a>.</p><p class="example">Thus, for example, a bubbling <code title="event-error">error</code> event fired on a child of <a href="dom.html#the-body-element-0">the
- body element</a> of a <code><a href="infrastructure.html#document">Document</a></code> would first trigger
- the <code title="handler-onerror"><a href="webappapis.html#handler-onerror">onerror</a></code> <a href="webappapis.html#event-handler-content-attributes">event handler
- content attributes</a> of that element, then that of the root
- <code><a href="semantics.html#the-html-element">html</a></code> element, and only <em>then</em> would it trigger
- the <code title="handler-window-onerror"><a href="webappapis.html#handler-window-onerror">onerror</a></code> <a href="webappapis.html#event-handler-content-attributes" title="event handler content attributes">event handler content
+ elements</a>.</p><p class="example">Thus, for example, a bubbling <code title="event-error">error</code> event dispatched on a child of
+ <a href="dom.html#the-body-element-0">the body element</a> of a <code><a href="infrastructure.html#document">Document</a></code> would first
+ trigger the <code title="handler-onerror"><a href="webappapis.html#handler-onerror">onerror</a></code> <a href="webappapis.html#event-handler-content-attributes">event
+ handler content attributes</a> of that element, then that of the
+ root <code><a href="semantics.html#the-html-element">html</a></code> element, and only <em>then</em> would it
+ trigger the <code title="handler-window-onerror"><a href="webappapis.html#handler-window-onerror">onerror</a></code>
+ <a href="webappapis.html#event-handler-content-attributes" title="event handler content attributes">event handler content
attribute</a> on the <code><a href="#the-body-element">body</a></code> element. This is because
the event would bubble from the target, to the <code><a href="#the-body-element">body</a></code>, to
the <code><a href="semantics.html#the-html-element">html</a></code>, to the <code><a href="infrastructure.html#document">Document</a></code>, to the
<code><a href="browsers.html#window">Window</a></code>, and the <a href="webappapis.html#event-handlers" title="event handlers">event
handler</a> on the <code><a href="#the-body-element">body</a></code> is watching the
<code><a href="browsers.html#window">Window</a></code> not the <code><a href="#the-body-element">body</a></code>. A regular event
- listener attached to the <code><a href="#the-body-element">body</a></code> using <code title="">addEventListener()</code>, however, would fire when the
+ listener attached to the <code><a href="#the-body-element">body</a></code> using <code title="">addEventListener()</code>, however, would be run when the
event bubbled through the <code><a href="#the-body-element">body</a></code> and not when it reaches
the <code><a href="browsers.html#window">Window</a></code> object.</p><div class="example">
Index: webappapis.html
===================================================================
RCS file: /sources/public/html5/spec/webappapis.html,v
retrieving revision 1.177
retrieving revision 1.178
diff -u -d -r1.177 -r1.178
--- webappapis.html 3 Jun 2011 00:48:43 -0000 1.177
+++ webappapis.html 4 Jun 2011 01:46:48 -0000 1.178
@@ -527,7 +527,7 @@
<ol><li><p>If the <a href="#script-s-global-object">script's global object</a> is a
<code><a href="browsers.html#window">Window</a></code> object whose <code><a href="infrastructure.html#document">Document</a></code> object is
not <a href="browsers.html#fully-active">fully active</a>, then abort these steps without doing
- anything. The callback is not fired.</p>
+ anything. The callback is not run.</p>
</li><li><p>Set the <a href="browsers.html#entry-script">entry script</a> to be the <a href="#concept-script" title="concept-script">script</a> being invoked.</p></li>
@@ -779,8 +779,8 @@
given task to one of the <a href="#task-queue" title="task queue">task queues</a>
of the relevant <a href="#event-loop">event loop</a>. All the tasks from one
particular <dfn id="task-source">task source</dfn> (e.g. the callbacks generated by
- timers, the events dispatched for mouse movements, the tasks queued
- for the parser) must always be added to the same <a href="#task-queue">task
+ timers, the events fired for mouse movements, the tasks queued for
+ the parser) must always be added to the same <a href="#task-queue">task
queue</a>, but tasks from different <a href="#task-source" title="task
source">task sources</a> may be placed in different <a href="#task-queue" title="task queue">task queues</a>.</p>
@@ -944,7 +944,7 @@
<p>This <a href="#task-source">task source</a> is used for features that react
to user interaction, for example keyboard or mouse input.</p>
- <p>Asynchronous events sent in response to user input (e.g. <code title="event-click"><a href="infrastructure.html#event-click">click</a></code> events) must be dispatched using
+ <p>Asynchronous events sent in response to user input (e.g. <code title="event-click"><a href="infrastructure.html#event-click">click</a></code> events) must be fired using
<a href="#concept-task" title="concept-task">tasks</a> <a href="#queue-a-task" title="queue a
task">queued</a> with the <a href="#user-interaction-task-source">user interaction task
source</a>. <a href="references.html#refsDOMEVENTS">[DOMEVENTS]</a></p>
@@ -1250,7 +1250,7 @@
<code><a href="#function">Function</a></code> object associated with the event handler
otherwise.</p>
- </div><p class="note"><a href="#event-handlers">Event handlers</a> <span class="impl">therefore</span> always fire before event listeners
+ </div><p class="note"><a href="#event-handlers">Event handlers</a> <span class="impl">therefore</span> always run before event listeners
attached using <code title="dom-EventTarget-addEventListener">addEventListener()</code>.</p><div class="impl">
<p class="note">The <var title="dom-event-listener">listener</var>
@@ -1431,16 +1431,16 @@
<p><dfn id="fire-a-simple-event" title="fire a simple event">Firing a simple event named <var title="">e</var></dfn> means that an event with the name <var title="">e</var>, which does not bubble (except where otherwise
stated) and is not cancelable (except where otherwise stated), and
- which uses the <code><a href="infrastructure.html#event">Event</a></code> interface, must be dispatched at
- the given target.</p>
+ which uses the <code><a href="infrastructure.html#event">Event</a></code> interface, must be created and
+ dispatched at the given target.</p>
<p><dfn id="fire-a-synthetic-mouse-event" title="fire a synthetic mouse event">Firing a synthetic
mouse event named <var title="">e</var></dfn> means that an event
with the name <var title="">e</var>, which does not bubble (except
where otherwise stated) and is not cancelable (except where
otherwise stated), and which uses the <code><a href="infrastructure.html#mouseevent">MouseEvent</a></code>
- interface, must be dispatched at the given target. The event object
- must have its <code title="">screenX</code>, <code title="">screenY</code>, <code title="">clientX</code>, <code title="">clientY</code>, and <code title="">button</code> attributes
+ interface, must be created and dispatched at the given target. The
+ event object must have its <code title="">screenX</code>, <code title="">screenY</code>, <code title="">clientX</code>, <code title="">clientY</code>, and <code title="">button</code> attributes
set to 0, its <code title="">ctrlKey</code>, <code title="">shiftKey</code>, <code title="">altKey</code>, and <code title="">metaKey</code> attributes set according to the current
state of the key input device, if any (false for any keys that are
not available), its <code title="">detail</code> attribute set to 1,
Received on Saturday, 4 June 2011 01:46:54 UTC