W3C home > Mailing lists > Public > public-html-commits@w3.org > June 2011

html5/spec common-dom-interfaces.html,1.53,1.54 dnd.html,1.62,1.63 infrastructure.html,1.1078,1.1079 interactive-elements.html,1.1038,1.1039 offline.html,1.1033,1.1034 sections.html,1.46,1.47 spec.html,1.1514,1.1515 the-iframe-element.html,1.63,1.64 the-map-element.html,1.45,1.46 timers.html,1.42,1.43 webappapis.html,1.177,1.178

From: Michael Smith via cvs-syncmail <cvsmail@w3.org>
Date: Sat, 04 Jun 2011 01:46:50 +0000
To: public-html-commits@w3.org
Message-Id: <E1QSfww-0000Ya-K5@lionel-hutz.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 &#8722;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>
    &#169; 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 GMT

This archive was generated by hypermail 2.2.0+W3C-0.50 : Saturday, 4 June 2011 01:46:56 GMT