Spec event wording suggestion.

View: New views
2 Messages — Rating Filter:   Alert me  

Spec event wording suggestion.

by Ric Hardacre-4 :: Rate this Message:

Reply to Author | View Threaded | Show Only this Message

Throughout the spec a phrase similar to the following is used (square
brackets indicate link to simple event definition):

"[fire a simple event] that bubbles called change at the element,"


The english is hard to follow and I also suggest that "called" is replaced
with "named" to remove some ambiguity about wether or not it is referring
to "calling" a function:

"fire a [bubbling simple event] named change at the element,"


The definition of the simple event would not need changing to accomodate
the above:

"which does not bubble (unless otherwise stated)"




Ric Hardacre
cyclomedia.co.uk




Re: Spec event wording suggestion.

by Ian Hickson :: Rate this Message:

Reply to Author | View Threaded | Show Only this Message

On Wed, 2 Sep 2009, Ric Hardacre wrote:

>
> Throughout the spec a phrase similar to the following is used (square
> brackets indicate link to simple event definition):
>
> "[fire a simple event] that bubbles called change at the element,"
>
>
> The english is hard to follow and I also suggest that "called" is replaced
> with "named" to remove some ambiguity about wether or not it is referring
> to "calling" a function:
>
> "fire a [bubbling simple event] named change at the element,"

I've changed 'called' to 'named' throughout.


> The definition of the simple event would not need changing to accomodate
> the above:
>
> "which does not bubble (unless otherwise stated)"

I haven't changed 'fire a simple event' to 'fire a bubbling simple event'
because there are so many axes that are affected, e.g. whether the event
is cancelable, what it's various attributes should be, etc.

--
Ian Hickson               U+1047E                )\._.,--....,'``.    fL
http://ln.hixie.ch/       U+263A                /,   _.. \   _\  ;`._ ,.
Things that are impossible just take longer.   `._.-(,_..'--(,_..'`-.;.'