--- a/source/xml-source.xml Wed Apr 19 18:19:52 2006 +0900
+++ b/source/xml-source.xml Wed Apr 19 21:41:52 2006 +0900
@@ -2376,13 +2376,12 @@
<method name="stopPropagation" id="Events-Event-stopPropagation">
<descr>
<p>
- This method is used to prevent event listeners of the same
- group from being triggered but its effect is deferred until all
- event listeners attached on the
- <code>Event.currentTarget</code> have been triggered (see
- <specref ref="Events-propagation-and-groups"/>). Once it has
- been called, further calls to this method have no additional
- effect.
+ Prevents event listeners of the same group from being triggered
+ but its effect is deferred until all event listeners attached
+ on the <code>Event.currentTarget</code> have been triggered
+ (see <specref ref="Events-propagation-and-groups"/>). Once it
+ has been called, further calls to this method have no
+ additional effect.
</p>
<note>
@@ -2412,10 +2411,9 @@
<method name="preventDefault" id="Events-Event-preventDefault">
<descr>
<p>
- If an event is cancelable, the <code>preventDefault</code>
- method is used to signify that the event is to be canceled,
- meaning any default action normally taken by the implementation
- as a result of the event will not occur (see also
+ Signifies that the event is to be canceled, meaning any default
+ action normally taken by the implementation as a result of the
+ event will not occur (see also
<specref ref="Events-flow-cancelation"/>). Calling this method
for a non-cancelable event has no effect.
</p>
@@ -2447,10 +2445,9 @@
<method name="initEvent" id="Events-Event-initEvent">
<descr>
<p>
- The <code>initEvent</code> method is used to initialize the
- value of an <code>Event</code> created through the
- <code>DocumentEvent.createEvent</code> method. This method may
- only be called before the <code>Event</code> has been
+ Initializes attributes of an <code>Event</code> created through
+ the <code>DocumentEvent.createEvent</code> method. This method
+ may only be called before the <code>Event</code> has been
dispatched via the <code>EventTarget.dispatchEvent()</code>
method. If the method is called several times before invoking
<code>EventTarget.dispatchEvent</code>, only the final
@@ -2530,11 +2527,10 @@
<method name="stopImmediatePropagation" id="Events-Event-stopImmediatePropagation" since="DOM Level 3">
<descr>
<p>
- This method is used to prevent event listeners of the same
- group from being triggered and, unlike
- <code>Event.stopPropagation()</code> its effect is immediate
- (see <specref ref="Events-propagation-and-groups"/>). Once it
- has been called, further calls to this method have no
+ Prevents event listeners of the same group from being triggered
+ and, unlike <code>Event.stopPropagation()</code> its effect is
+ immediate (see <specref ref="Events-propagation-and-groups"/>).
+ Once it has been called, further calls to this method have no
additional effect.
</p>
@@ -2574,9 +2570,8 @@
<method name="initEventNS" id="Events-Event-initEventNS" since="DOM Level 3">
<descr>
<p>
- The <code>initEventNS</code> method is used to initialize the
- value of an <code>Event</code> object and has the same behavior
- as <code>Event.initEvent()</code>.
+ Initializes attributes of an <code>Event</code> object. This
+ method has the same behavior as <code>Event.initEvent()</code>.
</p>
</descr>
@@ -2663,9 +2658,9 @@
<method name="initCustomEventNS" id="Events-Event-initCustomEventNS">
<descr>
<p>
- The <code>initCustomEventNS</code> method is used to initialize
- the value of a <code>CustomEvent</code> object and has the same
- behavior as <code>Event.initEventNS()</code>.
+ Initializes attributes of a <code>CustomEvent</code> object.
+ This method has the same behavior as
+ <code>Event.initEventNS()</code>.
</p>
</descr>
@@ -2768,15 +2763,15 @@
<method name="addEventListener" id="Events-EventTarget-addEventListener">
<descr>
<p>
- This method allows the registration of an event listener in the
- default group and, depending on the <code>useCapture</code>
- parameter, on the capture phase of the DOM event flow or its
- target and bubbling phases. Invoking this method is equivalent
- to invoking <code>addEventListenerNS</code> with the same
- values for the parameters <code>type</code>,
- <code>listener</code>, and <code>useCapture</code>, and the
- value <code>null</code> for the parameters
- <code>namespaceURI</code> and <code>evtGroup</code>.
+ Registers an event listener in the default group and, depending
+ on the <code>useCapture</code> parameter, on the capture phase
+ of the DOM event flow or its target and bubbling phases.
+ Invoking this method is equivalent to invoking
+ <code>addEventListenerNS</code> with the same values for the
+ parameters <code>type</code>, <code>listener</code>, and
+ <code>useCapture</code>, and the value <code>null</code> for
+ the parameters <code>namespaceURI</code> and
+ <code>evtGroup</code>.
</p>
</descr>
@@ -2833,13 +2828,12 @@
<method name="removeEventListener" id="Events-EventTarget-removeEventListener">
<descr>
<p>
- This method allows the removal of event listeners from the
- default group. Calling <code>removeEventListener</code> with
- arguments which do not identify any currently registered
- <code>EventListener</code> on the <code>EventTarget</code> has
- no effect. The <code>Event.namespaceURI</code> for which the
- user registered the event listener is implied and is
- <code>null</code>.
+ Removes an event listener from the default group. Calling
+ <code>removeEventListener</code> with arguments which do not
+ identify any currently registered <code>EventListener</code> on
+ the <code>EventTarget</code> has no effect. The
+ <code>Event.namespaceURI</code> for which the user registered
+ the event listener is implied and is <code>null</code>.
</p>
<note>
@@ -2902,8 +2896,7 @@
<method name="dispatchEvent" id="Events-EventTarget-dispatchEvent" version="DOM Level 3">
<descr>
<p>
- This method allows the dispatch of events into the
- implementation's event model. The
+ Dispatches an event into the implementation's event model. The
<termref def="dt-event-target">event target</termref> of the
event is the <code>EventTarget</code> object on which
<code>dispatchEvent</code> is called.
@@ -2972,10 +2965,10 @@
<method name="addEventListenerNS" id="Events-EventTargetGroup-addEventListenerNS" since="DOM Level 3">
<descr>
<p>
- This method allows the registration of an event listener in a
- specified group or the default group and, depending on the
- <code>useCapture</code> parameter, on the capture phase of the
- DOM event flow or its target and bubbling phases.
+ Registers an event listener in a specified group or the default
+ group and, depending on the <code>useCapture</code> parameter,
+ on the capture phase of the DOM event flow or its target and
+ bubbling phases.
</p>
</descr>
@@ -3041,11 +3034,11 @@
<method name="removeEventListenerNS" id="Events-EventTargetGroup-removeEventListenerNS" since="DOM Level 3">
<descr>
<p>
- This method allows the removal of an event listener,
- independently of the associated event group. Calling
- <code>removeEventListenerNS</code> with arguments which do not
- identify any currently registered <code>EventListener</code> on
- the <code>EventTarget</code> has no effect.
+ Removes an event listener, independently of the associated
+ event group. Calling <code>removeEventListenerNS</code> with
+ arguments which do not identify any currently registered
+ <code>EventListener</code> on the <code>EventTarget</code> has
+ no effect.
</p>
</descr>
@@ -3250,7 +3243,7 @@
<method name="createEvent" id="Events-DocumentEvent-createEvent">
<descr>
<p>
- This method creates an event object of the type specified.
+ Creates an event object of the type specified.
</p>
</descr>
@@ -3319,7 +3312,7 @@
<method name="canDispatch" id="Events-DocumentEvent-canDispatch" since="DOM Level 3">
<descr>
<p>
- Test if the implementation can generate events of a specified
+ Tests if the implementation can generate events of a specified
type.
</p>
</descr>
@@ -3421,9 +3414,9 @@
<method name="initUIEvent" id="Events-Event-initUIEvent">
<descr>
<p>
- The <code>initUIEvent</code> method is used to initialize the
- value of a <code>UIEvent</code> object and has the same
- behavior as <code>Event.initEvent()</code>.
+ Initializes attributes of an <code>UIEvent</code> object. This
+ method has the same behavior as
+ <code>Event.initEvent()</code>.
</p>
</descr>
@@ -3489,9 +3482,9 @@
<method name="initUIEventNS" id="Events-Event-initUIEventNS" since="DOM Level 3">
<descr>
<p>
- The <code>initUIEventNS</code> method is used to initialize
- the value of a <code>UIEvent</code> object and has the same
- behavior as <code>Event.initEventNS()</code>.
+ Initializes attributes of an <code>UIEvent</code> object. This
+ method has the same behavior as
+ <code>Event.initEventNS()</code>.
</p>
</descr>
@@ -4081,9 +4074,9 @@
<method name="initTextEvent" id="Events-Event-initTextEvent">
<descr>
<p>
- The <code>initTextEvent</code> method is used to initialize
- the value of a <code>TextEvent</code> object and has the same
- behavior as <code>UIEvent.initUIEvent()</code>. The value of
+ Initializes attributes of a <code>TextEvent</code> object.
+ This method has the same behavior as
+ <code>UIEvent.initUIEvent()</code>. The value of
<code>UIEvent.detail</code> remains undefined.
</p>
</descr>
@@ -4146,9 +4139,9 @@
<method name="initTextEventNS" id="Events-Event-initTextEventNS">
<descr>
<p>
- The <code>initTextEventNS</code> method is used to initialize
- the value of a <code>TextEvent</code> object and has the same
- behavior as <code>UIEvent.initUIEventNS()</code>. The value of
+ Initializes attributes of a <code>TextEvent</code> object.
+ This method has the same behavior as
+ <code>UIEvent.initUIEventNS()</code>. The value of
<code>UIEvent.detail</code> remains undefined.
</p>
</descr>
@@ -4498,9 +4491,9 @@
<method name="initMouseEvent" id="Events-Event-initMouseEvent">
<descr>
<p>
- The <code>initMouseEvent</code> method is used to initialize
- the value of a <code>MouseEvent</code> object and has the same
- behavior as <code>UIEvent.initUIEvent()</code>.
+ Initializes attributes of a <code>MouseEvent</code> object.
+ This method has the same behavior as
+ <code>UIEvent.initUIEvent()</code>.
</p>
</descr>
@@ -4692,9 +4685,9 @@
<method name="initMouseEventNS" id="Events-Event-initMouseEventNS" since="DOM Level 3">
<descr>
<p>
- The <code>initMouseEventNS</code> method is used to initialize
- the value of a <code>MouseEvent</code> object and has the same
- behavior as <code>UIEvent.initUIEventNS()</code>.
+ Initializes attributes of a <code>MouseEvent</code> object.
+ This method has the same behavior as
+ <code>UIEvent.initUIEventNS()</code>.
</p>
</descr>
@@ -5745,9 +5738,8 @@
<method name="initKeyboardEvent" id="Events-KeyboardEvent-initKeyboardEvent">
<descr>
<p>
- The <code>initKeyboardEvent</code> method is used to
- initialize the value of a <code>KeyboardEvent</code> object
- and has the same behavior as
+ Initializes attributes of a <code>KeyboardEvent</code> object.
+ This method has the same behavior as
<code>UIEvent.initUIEvent()</code>. The value of
<code>UIEvent.detail</code> remains undefined.
</p>
@@ -5830,9 +5822,8 @@
<method name="initKeyboardEventNS" id="Events-KeyboardEvent-initKeyboardEventNS">
<descr>
<p>
- The <code>initKeyboardEventNS</code> method is used to
- initialize the value of a <code>KeyboardEvent</code> object
- and has the same behavior as
+ Initializes attributes of a <code>KeyboardEvent</code> object.
+ This method has the same behavior as
<code>UIEvent.initUIEventNS()</code>. The value of
<code>UIEvent.detail</code> remains undefined.
</p>
@@ -6297,9 +6288,9 @@
<method name="initMutationEvent" id="Events-Event-initMutationEvent">
<descr>
<p>
- The <code>initMutationEvent</code> method is used to
- initialize the value of a <code>MutationEvent</code> object
- and has the same behavior as <code>Event.initEvent()</code>.
+ Initializes attributes of a <code>MutationEvent</code> object.
+ This method has the same behavior as
+ <code>Event.initEvent()</code>.
</p>
</descr>
@@ -6392,9 +6383,9 @@
<method name="initMutationEventNS" id="Events-Event-initMutationEventNS" since="DOM Level 3">
<descr>
<p>
- The <code>initMutationEventNS</code> method is used to
- initialize the value of a <code>MutationEvent</code> object
- and has the same behavior as <code>Event.initEventNS()</code>.
+ Initializes attributes of a <code>MutationEvent</code> object.
+ This method has the same behavior as
+ <code>Event.initEventNS()</code>.
</p>
</descr>
@@ -7242,9 +7233,8 @@
<method name="initMutationNameEvent" id="Events-Event-initMutationNameEvent" since="DOM Level 3">
<descr>
<p>
- The <code>initMutationNameEvent</code> method is used to
- initialize the value of a <code>MutationNameEvent</code>
- object and has the same behavior as
+ Initializes attributes of a <code>MutationNameEvent</code>
+ object. This method has the same behavior as
<code>MutationEvent.initMutationEvent()</code>.
</p>
</descr>
@@ -7320,9 +7310,8 @@
<method name="initMutationNameEventNS" id="Events-Event-initMutationNameEventNS" since="DOM Level 3">
<descr>
<p>
- The <code>initMutationNameEventNS</code> method is used to
- initialize the value of a <code>MutationNameEvent</code>
- object and has the same behavior as
+ Initializes attributes of a <code>MutationNameEvent</code>
+ object. This method has the same behavior as
<code>MutationEvent.initMutationEventNS()</code>.
</p>
</descr>