- From: Daniel Barclay <daniel@fgm.com>
- Date: Fri, 24 Sep 2010 13:15:18 -0400
- 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 UTC