various updates in response to 23/24 feb 2006 f2f resolutions
authorbjoern
Fri, 24 Feb 2006 21:21:51 +0900
changeset 4 9ca60962ce29
parent 3 1d92d0470ab4
child 5 063d255a86b3
various updates in response to 23/24 feb 2006 f2f resolutions
source/xml-source.xml
--- a/source/xml-source.xml	Fri Feb 24 18:48:40 2006 +0900
+++ b/source/xml-source.xml	Fri Feb 24 21:21:51 2006 +0900
@@ -1907,14 +1907,8 @@
 
      <ednote>
       <edtext>
-       There is an open issue
-       <loc href='http://www.w3.org/2005/06/tracker/webapi/issues/6'>ISSUE-6</loc>
-       concerned with whether this is the best way to introduce events
-       with associated namespaces into the event model. See also
-       <loc href='http://www.w3.org/2005/06/tracker/webapi/actions/42'>ACTION-42</loc>,
-       <loc href='http://www.w3.org/2005/06/tracker/webapi/actions/43'>ACTION-43</loc>,
-       <loc href='http://www.w3.org/mid/9fq4v15bh7hgdphttsoppgrstv6hpvrlpc@hive.bjoern.hoehrmann.de'>http://lists.w3.org/Archives/Member/member-webapi/2006Feb/0244</loc>,
-       <loc href='http://www.w3.org/2005/06/tracker/webapi/issues/18'>ISSUE-18</loc>.
+       This, like all other relevant sections, does not yet reflect the
+       changes to namespaced events the group agreed to.
       </edtext>
      </ednote>
 
@@ -2210,8 +2204,9 @@
        <descr>
         <p>
          The name should be an
-         <loc href="http://www.w3.org/TR/1999/REC-xml-names-19990114/#NT-NCName">NCName</loc>
-         as defined in <bibref ref="Namespaces"/> and is case-sensitive.
+         <loc href="http://www.w3.org/TR/2004/REC-xml-names11-20040204/#NT-NCName">NCName</loc>
+         as defined in <bibref ref="Namespaces11"/> and is
+         case-sensitive.
         </p>
 
         <p>
@@ -2445,32 +2440,6 @@
        </descr>
       </attribute>
 
-      <method name="isCustom" id="Events-Event-isCustom" since="DOM Level 3">
-       <descr>
-        <p>
-         This method will always return <code>false</code>, unless the
-         event implements the <code>CustomEvent</code> interface.
-        </p>
-       </descr>
-
-       <parameters>
-<!-- No parameters -->
-       </parameters>
-
-       <returns type="boolean">
-        <descr>
-         <p>
-          <code>false</code>, unless the event object implements the
-          <code>CustomEvent</code> interface.
-         </p>
-        </descr>
-       </returns>
-
-       <raises>
-<!-- no exception -->
-       </raises>
-      </method>
-
       <method name="stopImmediatePropagation" id="Events-Event-stopImmediatePropagation" since="DOM Level 3">
        <descr>
         <p>
@@ -2795,12 +2764,22 @@
            DISPATCH_REQUEST_ERR: Raised if the <code>Event</code> object
            is already being dispatched in the tree.
           </p>
-
+         </descr>
+        </exception>
+
+        <exception name="DOMException">
+         <descr>
           <p>
            NOT_SUPPORTED_ERR: Raised if the <code>Event</code> object
            has not been created using
-           <code>DocumentEvent.createEvent()</code> or does not support
-           the interface <code>CustomEvent</code>.
+           <code>DocumentEvent.createEvent()</code>.
+          </p>
+
+          <p>
+           INVALID_CHARACTER_ERR: Raised if <code>Event.type</code> is
+           not an
+           <xspecref href="http://www.w3.org/TR/2004/REC-xml-names11-20040204/#NT-NCName">NCName</xspecref>
+           as defined in <bibref ref="Namespaces11"/>.
           </p>
          </descr>
         </exception>
@@ -3068,15 +3047,6 @@
         </p>
        </descr>
       </constant>
-
-      <constant id="NOT_SUPPORTED_ERR" name="NOT_SUPPORTED_ERR" type="unsigned short" value="9" since="DOM Level 3">
-       <descr>
-        <p>
-         If the implementation does not support the requested type of
-         object or operation.
-        </p>
-       </descr>
-      </constant>
      </group>
     </definitions>
 
@@ -3284,133 +3254,85 @@
 <!-- UIEvent interface -->
       <interface name="CustomEvent" inherits="Event" id="Events-CustomEvent" since="DOM Level 3">
        <descr>
-        <ednote>
-         <edtext>
-          See
-          <loc href='http://lists.w3.org/Archives/Member/member-webapi/2006Feb/0005'>http://lists.w3.org/Archives/Member/member-webapi/2006Feb/0005</loc>,
-          <loc href='http://lists.w3.org/Archives/Member/member-webapi/2006Feb/0009'>http://lists.w3.org/Archives/Member/member-webapi/2006Feb/0009</loc>,
-          <loc href='http://www.w3.org/2005/06/tracker/webapi/actions/9'>ACTION-9</loc>,
-          <loc href='http://www.w3.org/2005/06/tracker/webapi/actions/10'>ACTION-10</loc>.
-         </edtext>
-        </ednote>
-
-        <p>
-         The <code>CustomEvent</code> interface gives access to the
-         attributes <code>Event.currentTarget</code> and
-         <code>Event.eventPhase</code>. It is intended to be used by the
-         DOM Events implementation to access the underlying current
-         target and event phase while dispatching a custom
-         <code>Event</code> in the tree; it is also intended to be
-         implemented, and <emph>not used</emph>, by DOM applications.
-        </p>
-
-        <p>
-         The methods contained in this interface are not intended to be
-         used by a DOM application, especially during the dispatch on
-         the <code>Event</code> object. Changing the current target or
-         the current phase may result in unpredictable results of the
-         event flow. The DOM Events implementation should ensure that
-         both methods return the appropriate current target and phase
-         before invoking each event listener on the current target to
-         protect DOM applications from malicious event listeners.
-        </p>
-
-        <note>
-         <p>
-          If this interface is supported by the event object,
-          <code>Event.isCustom()</code> must return <code>true</code>.
-         </p>
-        </note>
+        <p>
+         @@@
+        </p>
        </descr>
 
-       <method name="setDispatchState" id="Events-CustomEvent-setCurrentTarget">
+       <attribute id="Events-CustomEvent-detail" name="detail" type="DOMObject" readonly="yes">
         <descr>
          <p>
-          The <code>setDispatchState</code> method is used by the DOM
-          Events implementation to set the values of
-          <code>Event.currentTarget</code> and
-          <code>Event.eventPhase</code>. It also reset the states of
-          <code>isPropagationStopped</code> and
-          <code>isImmediatePropagationStopped</code>.
+          Specifies some detail information about the
+          <code>Event</code>.
+         </p>
+        </descr>
+       </attribute>
+
+       <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>.
          </p>
         </descr>
 
         <parameters>
-         <param name="target" type="EventTarget" attr="in">
-          <descr>
-           <p>
-            Specifies the new value for the
-            <code>Event.currentTarget</code> attribute.
-           </p>
-          </descr>
-         </param>
-
-         <param name="phase" type="unsigned short" attr="in">
-          <descr>
-           <p>
-            Specifies the new value for the
-            <code>Event.eventPhase</code> attribute.
+         <param name="namespaceURI" type="DOMString" attr="in">
+          <descr>
+           <p>
+            Refer to the <code>Event.initEventNS()</code> method for a
+            description of this parameter.
+           </p>
+          </descr>
+         </param>
+
+         <param name="typeArg" type="DOMString" attr="in">
+          <descr>
+           <p>
+            Refer to the <code>Event.initEventNS()</code> method for a
+            description of this parameter.
+           </p>
+          </descr>
+         </param>
+
+         <param name="canBubbleArg" type="boolean" attr="in">
+          <descr>
+           <p>
+            Refer to the <code>Event.initEventNS()</code> method for a
+            description of this parameter.
+           </p>
+          </descr>
+         </param>
+
+         <param name="cancelableArg" type="boolean" attr="in">
+          <descr>
+           <p>
+            Refer to the <code>Event.initEventNS()</code> method for a
+            description of this parameter.
+           </p>
+          </descr>
+         </param>
+
+         <param name="detailArg" type="DOMObject" attr="in">
+          <descr>
+           <p>
+            Specifies <code>CustomEvent.detail</code>.
            </p>
           </descr>
          </param>
         </parameters>
 
         <returns type="void">
-         <descr/>
-        </returns>
-
-        <raises/>
-       </method>
-
-       <method name="isPropagationStopped" id="Events-Event-isPropagationStopped">
-        <descr>
-         <p>
-          This method will return <code>true</code> if the method
-          <code>stopPropagation()</code> has been called for this event,
-          <code>false</code> in any other cases.
-         </p>
-        </descr>
-
-        <parameters/>
-
-        <returns type="boolean">
          <descr>
           <p>
-           <code>true</code> if the event propagation has been stopped
-           in the current group.
+<!--empty paragraph-->
           </p>
          </descr>
         </returns>
 
         <raises>
-<!-- no exception -->
-        </raises>
-       </method>
-
-       <method name="isImmediatePropagationStopped" id="Events-Event-isImmediatePropagationStopped">
-        <descr>
-         <p>
-          The <code>isImmediatePropagationStopped</code> method is used
-          by the DOM Events implementation to know if the method
-          <code>stopImmediatePropagation()</code> has been called for
-          this event. It returns <code>true</code> if the method has
-          been called, <code>false</code> otherwise.
-         </p>
-        </descr>
-
-        <parameters/>
-
-        <returns type="boolean">
-         <descr>
-          <p>
-           <code>true</code> if the event propagation has been stopped
-           immediately in the current group.
-          </p>
-         </descr>
-        </returns>
-
-        <raises>
-<!-- no exception -->
+<!-- No exceptions -->
         </raises>
        </method>
       </interface>
@@ -3713,7 +3635,7 @@
             <code>Element</code>
            </td>
           </tr>
-<!--<tr><th>Default action</th><td>...</td></tr>-->
+
           <tr>
            <th>
             Context info
@@ -3808,7 +3730,7 @@
             <code>Element</code>
            </td>
           </tr>
-<!--<tr><th>Default action</th><td>...</td></tr>-->
+
           <tr>
            <th>
             Context info
@@ -3897,7 +3819,7 @@
             Element
            </td>
           </tr>
-<!--<tr><th>Default action</th><td>...</td></tr>-->
+
           <tr>
            <th>
             Context info
@@ -4190,7 +4112,7 @@
             <code>Element</code>
            </td>
           </tr>
-<!--<tr><th>Default action</th><td>...</td></tr>-->
+
           <tr>
            <th>
             Context info
@@ -4379,21 +4301,8 @@
         <descr>
          <p>
           Used to identify a secondary <code>EventTarget</code> related
-          to a UI event. Currently this attribute is used with the
-          <code>ev:mouseover</code> event to indicate the
-          <code>EventTarget</code> which the pointing device exited and
-          with the <code>ev:mouseout</code> event to indicate the
-          <code>EventTarget</code> which the pointing device entered.
-         </p>
-
-         <ednote>
-          <edtext>
-           There is an open issue
-           <loc href='http://www.w3.org/2005/06/tracker/webapi/issues/7'>ISSUE-7</loc>
-           concerned with whether and when this attribute may be
-           <code>null</code>.
-          </edtext>
-         </ednote>
+          to a UI event, depending on the type of event.
+         </p>
         </descr>
        </attribute>
 
@@ -4831,7 +4740,7 @@
             <code>Element</code>
            </td>
           </tr>
-<!--<tr><th>Default action</th><td>...</td></tr>-->
+
           <tr>
            <th>
             Context info
@@ -4966,7 +4875,7 @@
             <code>Element</code>
            </td>
           </tr>
-<!--<tr><th>Default action</th><td>...</td></tr>-->
+
           <tr>
            <th>
             Context info
@@ -5068,7 +4977,7 @@
             <code>Element</code>
            </td>
           </tr>
-<!--<tr><th>Default action</th><td>...</td></tr>-->
+
           <tr>
            <th>
             Context info
@@ -5168,7 +5077,7 @@
             <code>Element</code>
            </td>
           </tr>
-<!--<tr><th>Default action</th><td>...</td></tr>-->
+
           <tr>
            <th>
             Context info
@@ -5186,7 +5095,7 @@
             <code>UIEvent.view</code> are in use.
             <code>MouseEvent.relatedTarget</code> indicates the
             <termref def="dt-event-target">event target</termref> a
-            pointing device is exiting.
+            pointing device is exiting, if any.
            </td>
           </tr>
          </tbody>
@@ -5267,7 +5176,7 @@
             <code>Element</code>
            </td>
           </tr>
-<!--<tr><th>Default action</th><td>...</td></tr>-->
+
           <tr>
            <th>
             Context info
@@ -5363,7 +5272,7 @@
             <code>Element</code>
            </td>
           </tr>
-<!--<tr><th>Default action</th><td>...</td></tr>-->
+
           <tr>
            <th>
             Context info
@@ -5381,7 +5290,7 @@
             <code>UIEvent.view</code> are in use.
             <code>MouseEvent.relatedTarget</code> indicates the
             <termref def="dt-event-target">event target</termref> a
-            pointing device is entering.
+            pointing device is entering, if any.
            </td>
           </tr>
          </tbody>
@@ -5930,7 +5839,7 @@
             <code>Element</code>
            </td>
           </tr>
-<!--<tr><th>Default action</th><td>...</td></tr>-->
+
           <tr>
            <th>
             Context info
@@ -6030,7 +5939,7 @@
             <code>Element</code>
            </td>
           </tr>
-<!--<tr><th>Default action</th><td>...</td></tr>-->
+
           <tr>
            <th>
             Context info
@@ -6494,7 +6403,7 @@
             <code>Element</code>, <code>Attr</code>
            </td>
           </tr>
-<!--<tr><th>Default action</th><td>...</td></tr>-->
+
           <tr>
            <th>
             Context info
@@ -6592,7 +6501,7 @@
             <code>ProcessingInstruction</code>
            </td>
           </tr>
-<!--<tr><th>Default action</th><td>...</td></tr>-->
+
           <tr>
            <th>
             Context info
@@ -6686,7 +6595,7 @@
             <code>ProcessingInstruction</code>
            </td>
           </tr>
-<!--<tr><th>Default action</th><td>...</td></tr>-->
+
           <tr>
            <th>
             Context info
@@ -6779,7 +6688,7 @@
             <code>ProcessingInstruction</code>
            </td>
           </tr>
-<!--<tr><th>Default action</th><td>...</td></tr>-->
+
           <tr>
            <th>
             Context info
@@ -6875,7 +6784,7 @@
             <code>ProcessingInstruction</code>
            </td>
           </tr>
-<!--<tr><th>Default action</th><td>...</td></tr>-->
+
           <tr>
            <th>
             Context info
@@ -6968,7 +6877,7 @@
             <code>Element</code>
            </td>
           </tr>
-<!--<tr><th>Default action</th><td>...</td></tr>-->
+
           <tr>
            <th>
             Context info
@@ -7084,7 +6993,7 @@
             <code>Element</code>
            </td>
           </tr>
-<!--<tr><th>Default action</th><td>...</td></tr>-->
+
           <tr>
            <th>
             Context info
@@ -7401,7 +7310,7 @@
             <code>Element</code>
            </td>
           </tr>
-<!--<tr><th>Default action</th><td>...</td></tr>-->
+
           <tr>
            <th>
             Context info
@@ -7492,7 +7401,7 @@
             <code>Element</code>
            </td>
           </tr>
-<!--<tr><th>Default action</th><td>...</td></tr>-->
+
           <tr>
            <th>
             Context info
@@ -7625,7 +7534,7 @@
             <code>Document</code>, <code>Element</code>
            </td>
           </tr>
-<!--<tr><th>Default action</th><td>...</td></tr>-->
+
           <tr>
            <th>
             Context info
@@ -7717,7 +7626,7 @@
             <code>Document</code>, <code>Element</code>
            </td>
           </tr>
-<!--<tr><th>Default action</th><td>...</td></tr>-->
+
           <tr>
            <th>
             Context info
@@ -7808,7 +7717,7 @@
             <code>Element</code>
            </td>
           </tr>
-<!--<tr><th>Default action</th><td>...</td></tr>-->
+
           <tr>
            <th>
             Context info
@@ -7895,7 +7804,7 @@
             <code>Element</code>
            </td>
           </tr>
-<!--<tr><th>Default action</th><td>...</td></tr>-->
+
           <tr>
            <th>
             Context info
@@ -7993,7 +7902,7 @@
             <code>Element</code>
            </td>
           </tr>
-<!--<tr><th>Default action</th><td>...</td></tr>-->
+
           <tr>
            <th>
             Context info
@@ -8081,7 +7990,7 @@
             <code>Element</code>
            </td>
           </tr>
-<!--<tr><th>Default action</th><td>...</td></tr>-->
+
           <tr>
            <th>
             Context info
@@ -8169,7 +8078,7 @@
             <code>Element</code>
            </td>
           </tr>
-<!--<tr><th>Default action</th><td>...</td></tr>-->
+
           <tr>
            <th>
             Context info
@@ -8257,7 +8166,7 @@
             <code>Element</code>
            </td>
           </tr>
-<!--<tr><th>Default action</th><td>...</td></tr>-->
+
           <tr>
            <th>
             Context info
@@ -8345,7 +8254,7 @@
             <code>Document</code>, <code>Element</code>
            </td>
           </tr>
-<!--<tr><th>Default action</th><td>...</td></tr>-->
+
           <tr>
            <th>
             Context info
@@ -8432,7 +8341,7 @@
             <code>Document</code>, <code>Element</code>
            </td>
           </tr>
-<!--<tr><th>Default action</th><td>...</td></tr>-->
+
           <tr>
            <th>
             Context info
@@ -12168,8 +12077,7 @@
 
    <ednote>
     <edtext>
-     On Windows systems the specgenerator seems to use <code>\</code> in
-     paths... The paths to .zip versions have to be updated.
+     Paths should use <code>/</code> rather than <code>\</code>.
     </edtext>
    </ednote>