W3C home > Mailing lists > Public > www-dom@w3.org > July to September 2010

DOM Level 3 Events section 3 (really 3 this time) editorial errors

From: Daniel Barclay <daniel@fgm.com>
Date: Fri, 24 Sep 2010 13:15:18 -0400
Message-ID: <4C9CDCA6.2040605@fgm.com>
To: <www-dom@w3.org>
In reading the Document Object Model (DOM) Level 3 Events
Specification, specifically, the version currently (2010-09-23) at
http://www.w3.org/TR/DOM-Level-3-Events/ ("Draft 07 September 2010"),
I noticed a number of mostly editorial errors in Section 3:


Section 3.1:

* The text says:

     This ensures that an event object may be properly dispatched
     multiple times while also allowing to prevent the event objects
     propagation or default actions prior to the event dispatch.

   "event objects propagation" should be "event object's propagation"

   "allowing to prevent" should be "allowing preventing" (or maybe
   "allowing one to prevent")

* The text says:

     Such events are handled in a synchronous manner, the event
     propagation that causes the event listener to be triggered must
     resume only after the event dispatch of the new event is
     completed.

  The comma should be a semicolon (or a sentence break).


Section 3.2:

* The text says:

     An example is the [HTML5] form element.

   That should probably be:

     An example is the HTML5 [HTML5] form element.

   or:

     An example is the HTML [HTML5] form element.

   or:

     An example is the HTML form element [HTML5].

   (Note how section 3.3.1 says "HTML5 [HTML5] defines its event
   operations...")

* "to associate new default actions to" should probably be "to
   associate ... with"


Section 3.3:

* The text says:

     Events may occur either synchronously ("sync") or asynchronously
     ("async").

     Events which are synchronous must be ...

     Events which are asynchronous may be ...

   As written, that defines "sync" as "sychronously" (even though it
   really means "synchronous").   (One can have sync events and async
   events, but doing something "sync" or doing it "async" either
   makes no sense or is very ungrammatical.)

   The text should probably say:

     Events may occur either synchronously or asynchronously.

     Events which are synchronous ("sync events") must be ...

     Events which are asynchronous ("sync events") may be ...

* "Each ... are fired ..." should be "Each ... is fired ..."


Section 3.4:

* "Events which are generated ... are trusted" should probably be
   "Events that are generated ... are trusted."  (Some other uses
   of "which" don't seem right either.)

* "events generated by script" should be "... by scripts"

* "have a have a" -> "have a"

* "these activation behavior" -> "these activation behaviors"


Section 3.5:

* "when applying that attributes or attribute value" should
   (apparently) be "... those attributes or attribute values"


Section 3.5.1:

* The text says:

     "... when it does not result from a user activating a button ..."

  Grammatically, that really should be:

    "... when it does not result from a user's activating a button ..."

  (It's talking about the activating done by the user, not the user
  in the state of or in the process of activating.)

* "implementation dependent" -> "implementation-dependent"

* "device dependent" -> "device-dependent", "application dependent"
   -> "application-dependent"


** There is a second section 3.5.1.


Daniel
Received on Friday, 24 September 2010 17:16:02 GMT

This archive was generated by hypermail 2.2.0+W3C-0.50 : Friday, 22 June 2012 06:14:05 GMT