validated, fixed typos, prepared for LC publication
authorschepers
Thu, 26 May 2011 02:22:43 +0900
changeset 326 3e9fff4c9f9e
parent 325 4edab5c10930
child 327 c3704525998d
validated, fixed typos, prepared for LC publication
html/DOM3-Events.html
--- a/html/DOM3-Events.html	Wed May 25 09:23:51 2011 +0900
+++ b/html/DOM3-Events.html	Thu May 26 02:22:43 2011 +0900
@@ -25,21 +25,21 @@
       </p>
       <h1 id="Overview-title">Document Object Model (DOM) Level 3 Events Specification</h1>
 <!-- @-->
-      <h2 id="Overview-W3C-doctype">W3C Editor's Draft <time datetime="2011-05-24">24 May 2011</time></h2>
+      <h2 id="Overview-W3C-doctype">W3C Editor's Draft <span class="2011-05-24">24 May 2011</span></h2>
       <dl>
         <dt>This version:</dt>
-        <dd><a href="http://dev.w3.org/2006/webapi/DOM-Level-3-Events/html/DOM3-Events.html?rev=1.199">http://dev.w3.org/2006/webapi/DOM-Level-3-Events/html/DOM3-Events.html?rev=1.199</a></dd>
+        <dd><a href="http://dev.w3.org/2006/webapi/DOM-Level-3-Events/html/DOM3-Events.html?rev=1.200">http://dev.w3.org/2006/webapi/DOM-Level-3-Events/html/DOM3-Events.html?rev=1.200</a></dd>
 
         <dt>Latest stable version:</dt>
         <dd><a href="http://www.w3.org/TR/DOM-Level-3-Events">http://www.w3.org/TR/DOM-Level-3-Events</a></dd>
 
         <dt>Previous version:</dt>
-        <dd><a href="http://dev.w3.org/cvsweb/~checkout~/2006/webapi/DOM-Level-3-Events/html/DOM3-Events.html?rev=1.198">http://dev.w3.org/cvsweb/~checkout~/2006/webapi/DOM-Level-3-Events/html/DOM3-Events.html?rev=1.198</a></dd>
+        <dd><a href="http://dev.w3.org/cvsweb/~checkout~/2006/webapi/DOM-Level-3-Events/html/DOM3-Events.html?rev=1.199">http://dev.w3.org/cvsweb/~checkout~/2006/webapi/DOM-Level-3-Events/html/DOM3-Events.html?rev=1.199</a></dd>
 
         <dt>Editor's Draft:</dt>
         <dd><a href="http://dev.w3.org/2006/webapi/DOM-Level-3-Events/html/DOM3-Events.html">http://dev.w3.org/2006/webapi/DOM-Level-3-Events/html/DOM3-Events.html</a></dd>
 
-		    <br/>
+		    <dd><br/></dd>
         <dt>Public Comments:</dt>
         <dd>
           <a href="mailto:www-dom@w3.org">www-dom@w3.org</a> 
@@ -56,7 +56,7 @@
         <dd>Doug Schepers, <em>W3C</em></dd>
 		    <dd>Jacob Rossi, <em>Microsoft</em></dd>
 		    
-		    <br/>
+		    <dd><br/></dd>
         <dd>Bj&#xF6;rn H&#xF6;hrmann, <em>Invited Expert (until December 2007)</em></dd>
         <dd>Philippe Le H&#xE9;garet, <em>W3C (until November 2003)</em></dd>
         <dd>Tom Pixley, <em>Netscape Communications Corporation (until July 2002)</em></dd>
@@ -84,7 +84,7 @@
       <p><em>This section describes the status of this document at the time of its publication. Other documents may supersede this document. A list of current W3C publications and the latest revision of this technical report can be found in the <a href="http://www.w3.org/TR/">W3C technical reports index</a> at http://www.w3.org/TR/.</em></p>
       
       <p>This document is the Editor's Draft of a Last Call Working Draft of the Document Object Model Level 3 Events (DOM3 Events) specification. This document was previously published as a W3C Note, pending further feedback from implementers, and is now being revised to reflect the current state of implementation.  It is expected that this specification will progress to W3C Recommendation status after review and refinement.</p>
-      <p>The <a href="http://www.w3.org/2008/webapps/">Web Applications Working Group</a> (WebApps WG) believes this specification to be feature complete, subject to further feedback during the Last Call period.  The Last Call period extends through 18 October 2010.  The public is encouraged to send comments to the WebApps Working Group's public mailing list for DOM specifications <a href="mailto:www-dom@w3.org">www-dom@w3.org</a> (<a href="http://lists.w3.org/Archives/Public/www-dom/">archive</a>).  See <a href="http://www.w3.org/Mail/">W3C mailing list and archive usage guidelines</a>.</p> 
+      <p>The <a href="http://www.w3.org/2008/webapps/">Web Applications Working Group</a> (WebApps WG) believes this specification to be feature complete, subject to further feedback during the Last Call period.  The Last Call period extends through 28 June 2011.  The public is encouraged to send comments to the WebApps Working Group's public mailing list for DOM specifications <a href="mailto:www-dom@w3.org">www-dom@w3.org</a> (<a href="http://lists.w3.org/Archives/Public/www-dom/">archive</a>).  See <a href="http://www.w3.org/Mail/">W3C mailing list and archive usage guidelines</a>.</p> 
 
 
       <p id="this-document-is-produced-by-the-web-app">This document is produced
@@ -1134,9 +1134,9 @@
                             <dt><a id="addEventListener_useCapture"><code class="parameter-name">useCapture</code></a> of type <code>boolean</code></dt>
                             <dd>
                               <p>If true, <code>useCapture</code> indicates that the user wishes to add the event listener for the <a class="def" href="#glossary-capture-phase">capture</a> and <a class="def" href="#glossary-target-phase">target</a> phases only, i.e., this event listener will not be triggered during the <a class="def" href="#glossary-bubbling-phase">bubbling</a> phase.  If <code>false</code>, the event listener must only be triggered during the <a class="def" href="#glossary-target-phase">target</a> and <a class="def" href="#glossary-bubbling-phase">bubbling</a> phases.</p>
-                              <p>This parameter may be optional, on an implementation-specific basis.  If not provided, the <a href="#events-EventTarget-addEventListener">EventTarget.addEventListener</a> method must behave as if <a id="addEventListener_useCapture"><code class="parameter-name">useCapture</code></a> were specified to be <code>false</code>.  See the non-normative <a id="webidl-events-EventTarget" href="#webidl-events-EventTarget">Interface EventTarget</a> WebIDL definition for a formal description.</p>
+                              <p>This parameter may be optional, on an implementation-specific basis.  If not provided, the <a href="#events-EventTarget-addEventListener">EventTarget.addEventListener</a> method must behave as if <a href="#addEventListener_useCapture"><code class="parameter-name">useCapture</code></a> were specified to be <code>false</code>.  See the non-normative <a href="#webidl-events-EventTarget">Interface EventTarget</a> WebIDL definition for a formal description.</p>
                               <p class="note" id="addEventListener_useCapture-java"><strong>Note:</strong>  For programming languages which do not allow optional method parameters, such as Java, the implementation may provide two <a href="#events-EventTarget-addEventListener">EventTarget.addEventListener</a> methods, one with 2 parameters, and one with 3 parameters.</p>
-                              <p class="note" id="addEventListener_useCapture-author"><strong>Authoring Note:</strong>  The <a id="addEventListener_useCapture"><code class="parameter-name">useCapture</code></a> parameter was required in DOM2 Events [<a href="#references-DOM2Events">DOM2 Events</a>], and omitting this parameter may cause an error in older implementations.</p>
+                              <p class="note" id="addEventListener_useCapture-author"><strong>Authoring Note:</strong>  The <a href="#events-EventTarget-addEventListener"><code class="parameter-name">useCapture</code></a> parameter was required in DOM2 Events [<a href="#references-DOM2Events">DOM2 Events</a>], and omitting this parameter may cause an error in older implementations.</p>
                             </dd>
                           </dl>
                         </div>
@@ -1164,12 +1164,12 @@
                             <dd><p>Specifies the <a href="#events-event-type-type"><code>Event.type</code></a> for which the user registered the event listener.</p></dd>
                             <dt><code class="parameter-name">listener</code> of type <a href="#events-EventListener"><code>EventListener</code></a></dt>
                             <dd><p>The <a href="#events-EventListener"><code>EventListener</code></a> to be removed.</p></dd>
-                            <dt><code class="parameter-name">useCapture</code> of type <code>boolean</code></dt>
+                            <dt><code id="removeEventListener_useCapture" class="parameter-name">useCapture</code> of type <code>boolean</code></dt>
                             <dd>
                               <p>Specifies whether the <a href="#events-EventListener"><code>EventListener</code></a> being removed was registered for the capture phase or not. If a listener was registered twice, once for the capture and target phases and once for the target and bubbling phases, each must be removed separately. Removal of an event listener registered for the capture and target phases does not affect the same event listener registered for the target and bubbling phases, and vice versa.</p>
-                              <p>This parameter may be optional, on an implementation-specific basis.  If not provided, the <a href="#events-EventTarget-removeEventListener">EventTarget.removeEventListener</a> method must behave as if <a id="removeEventListener_useCapture"><code class="parameter-name">useCapture</code></a> were specified to be <code>false</code>, including the removal of event listeners which had an <a href="#events-EventTarget-addEventListener">EventTarget.addEventListener</a> <a id="addEventListener_useCapture"><code class="parameter-name">useCapture</code></a> value of <code>false</code>.  See the non-normative <a id="webidl-events-EventTarget" href="#webidl-events-EventTarget">Interface EventTarget</a> WebIDL definition for a formal description</p>
+                              <p>This parameter may be optional, on an implementation-specific basis.  If not provided, the <a href="#events-EventTarget-removeEventListener">EventTarget.removeEventListener</a> method must behave as if <a href="#removeEventListener_useCapture"><code class="parameter-name">useCapture</code></a> were specified to be <code>false</code>, including the removal of event listeners which had an <a href="#events-EventTarget-addEventListener">EventTarget.addEventListener</a> <a href="#events-EventTarget-addEventListener"><code class="parameter-name">useCapture</code></a> value of <code>false</code>.  See the non-normative <a href="#webidl-events-EventTarget">Interface EventTarget</a> WebIDL definition for a formal description</p>
                               <p class="note" id="removeEventListener_useCapture-java"><strong>Note:</strong>  For programming languages which do not allow optional method parameters, such as Java, the implementation may provide two <a href="#events-EventTarget-removeEventListener">EventTarget.removeEventListener</a> methods, one with 2 parameters, and one with 3 parameters.</p>
-                              <p class="note" id="removeEventListener_useCapture-author"><strong>Authoring Note:</strong>  The <a id="removeEventListener_useCapture"><code class="parameter-name">useCapture</code></a> parameter was required in DOM2 Events [<a href="#references-DOM2Events">DOM2 Events</a>], and omitting this parameter may cause an error in older implementations.</p>
+                              <p class="note" id="removeEventListener_useCapture-author"><strong>Authoring Note:</strong>  The <a href="#removeEventListener_useCapture"><code class="parameter-name">useCapture</code></a> parameter was required in DOM2 Events [<a href="#references-DOM2Events">DOM2 Events</a>], and omitting this parameter may cause an error in older implementations.</p>
                             </dd>
                           </dl>
                         </div>
@@ -5378,6 +5378,12 @@
                 <td class="category">General</td>
               </tr>
               <tr>
+                <td><code id="key-Apps" class="value keyname">'Apps'</code></td>
+                <td> </td>
+                <td>Toggle display of available (interactive) application list.</td>
+                <td class="category">General</td>
+              </tr>
+              <tr>
                 <td><code id="key-Crsel" class="value keyname">'Crsel'</code></td>
                 <td> </td>
                 <td>The Cursor Select (Crsel) key.</td>
@@ -5552,36 +5558,12 @@
                 <td class="category">General</td>
               </tr>
               <tr>
-                <td><code id="key-Exit" class="value keyname">'Exit'</code></td>
-                <td> </td>
-                <td>Exit current state or current application (as appropriate).</td>
-                <td class="category">General</td>
-              </tr>
-              <tr>
                 <td><code id="key-List" class="value keyname">'List'</code></td>
                 <td> </td>
                 <td>Toggle display listing of currently available content or programs.</td>
                 <td class="category">General</td>
               </tr>
               <tr>
-                <td><code id="key-Menu" class="value keyname">'Menu'</code></td>
-                <td> </td>
-                <td>Toggle display of content or system menu, if available.</td>
-                <td class="category">General</td>
-              </tr>
-              <tr>
-                <td><code id="key-Help" class="value keyname">'Help'</code></td>
-                <td> </td>
-                <td>Toggle display of help information.</td>
-                <td class="category">General</td>
-              </tr>
-              <tr>
-                <td><code id="key-Info" class="value keyname">'Info'</code></td>
-                <td> </td>
-                <td>Toggle display of information about currently selected context or media.</td>
-                <td class="category">General</td>
-              </tr>
-              <tr>
                 <td><code id="key-Props" class="value keyname">'Props'</code></td>
                 <td> </td>
                 <td>The properties (props) key.</td>
@@ -5611,18 +5593,6 @@
                 <td>General purpose virtual function key, as index 4.</td>
                 <td class="category">General</td>
               </tr>
-              <tr>
-                <td><code id="key-Apps" class="value keyname">'Apps'</code></td>
-                <td> </td>
-                <td>Toggle display of available (interactive) application list.</td>
-                <td class="category">General</td>
-              </tr>
-               <tr>
-                 <td><code id="key-Help" class="value keyname">'Help'</code></td>
-                 <td> </td>
-                 <td>Toggle display of help information.</td>
-                 <td class="category">General</td>
-               </tr>
 
 
                <tr>
@@ -5641,7 +5611,7 @@
                  <td><code id="key-Enter" class="value keyname">'Enter'</code></td>
                  <td> </td>
                  <td>The Enter key, to activate current selection or accept current input.
-                  <span class="note" id="_58"><strong>Note:</strong> This key value also must be used for the <code>Return</code> (Macintosh numpad) key.</span></th>
+                  <span class="note" id="_58"><strong>Note:</strong> This key value also must be used for the <code>Return</code> (Macintosh numpad) key.</span></td>
                  <td class="category">UI</td>
                </tr>
                <tr>
@@ -5653,7 +5623,19 @@
                <tr>
                  <td><code id="key-Help" class="value keyname">'Help'</code></td>
                  <td> </td>
-                 <td>The Help key.</td>
+                 <td>Toggle display of help information.</td>
+                 <td class="category">UI</td>
+               </tr>
+               <tr>
+                 <td><code id="key-Info" class="value keyname">'Info'</code></td>
+                 <td> </td>
+                 <td>Toggle display of information about currently selected context or media.</td>
+                 <td class="category">UI</td>
+               </tr>
+               <tr>
+                 <td><code id="key-Menu" class="value keyname">'Menu'</code></td>
+                 <td> </td>
+                 <td>Toggle display of content or system menu, if available.</td>
                  <td class="category">UI</td>
                </tr>
                <tr>
@@ -5703,7 +5685,7 @@
               <tr>
                 <td><code id="key-Spacebar" class="value keyname">'Spacebar'</code></td>
                 <td><a id="key-U-0020"><code class="value charval">'\u0020'</code></a></td>
-                <td>The Space (Spacebar) key (<code class="value charrep">'&nbsp;'</code>).</th>
+                <td>The Space (Spacebar) key (<code class="value charrep">'&nbsp;'</code>).</td>
                 <td class="category">Character</td>
               </tr>
 
@@ -5723,7 +5705,7 @@
                 <td><code id="key-Multiply" class="value keyname">'Multiply'</code></td>
                 <td><a id="key-U-002A"><code class="value charval">'\u002A'</code></a></td>
                 <td>The Multiply key, or multiplication sign (<code class="value charrep">'*'</code>).
-                  <span class="note" id="note-Multiply"><strong>Note:</strong> This key value may be represented by different characters depending on context, including <code id="key-U-002A" class="value charval">'\u002A' (ASTERISK, '*')</code> or <code id="key-U-00D7" class="value charval">'\u00D7' (MULTIPLICATION SIGN, '×')</code>.</span>
+                  <span class="note" id="note-Multiply"><strong>Note:</strong> This key value may be represented by different characters depending on context, including <code class="value charval">'\u002A' (ASTERISK, '*')</code> or <code id="key-U-00D7" class="value charval">'\u00D7' (MULTIPLICATION SIGN, '×')</code>.</span>
                 </td>
                 <td class="category">Character / Math</td>
               </tr>
@@ -5751,13 +5733,13 @@
               <tr>
                 <td><code id="key-BrightnessDown" class="value keyname">'BrightnessDown'</code></td>
                 <td> </td>
-                <td>The Brightness Down key.  Typically controls the display brightness.</th>
+                <td>The Brightness Down key.  Typically controls the display brightness.</td>
                 <td class="category">Device</td>
               </tr>
               <tr>
                 <td><code id="key-BrightnessUp" class="value keyname">'BrightnessUp'</code></td>
                 <td> </td>
-                <td>The Brightness Up key.  Typically controls the display brightness.</th>
+                <td>The Brightness Up key.  Typically controls the display brightness.</td>
                 <td class="category">Device</td>
               </tr>
               <tr>
@@ -5776,7 +5758,7 @@
                 <td><code id="key-Power" class="value keyname">'Power'</code></td>
                 <td> </td>
                 <td>Toggle power state.
-                 <span class="note" id="note-key-power"><strong>Note:</strong> Some devices may not expose this key to the operating environment.</span></th>
+                 <span class="note" id="note-key-power"><strong>Note:</strong> Some devices may not expose this key to the operating environment.</span></td>
                 <td class="category">Device</td>
               </tr>
               <tr>
@@ -6114,7 +6096,7 @@
                 <td> </td>
                 <td>The Meta key, to enable meta modifier function for interpreting concurrent or subsequent keyboard input.
                   <span class="note" id="note-meta-key"><strong>Note:</strong> This key value is also used for the Apple <code>'Command'</code> key.</span>
-                </th>
+                </td>
                 <td class="category">Modifier</td>
               </tr>
               <tr>
@@ -6193,7 +6175,7 @@
               <tr>
                 <td><code id="key-FinalMode" class="value keyname">'FinalMode'</code></td>
                 <td> </td>
-                <td>The Final Mode (Final) key used on some Asian keyboards, to enable the final mode for IMEs.</th>
+                <td>The Final Mode (Final) key used on some Asian keyboards, to enable the final mode for IMEs.</td>
                 <td class="category">IME</td>
               </tr>
               <tr>
@@ -6733,7 +6715,7 @@
               <tr>
                 <td><code id="key-Unidentified" class="value keyname">'Unidentified'</code></td>
                 <td> </td>
-                <td>This key value is used when an implementations is unable to identify another key value, due to either hardware, platform, or software constraints.</th>
+                <td>This key value is used when an implementations is unable to identify another key value, due to either hardware, platform, or software constraints.</td>
                 <td class="category">Special</td>
               </tr>
             </table>
@@ -6890,11 +6872,11 @@
       	<tr><th>Plus (+)</th> <td>187</td></tr>
       	<tr><th>Equals sign (=)</th> <td>187</td></tr>
       	<tr><th>Comma (,)</th> <td>188</td></tr>
-      	<tr><th>Less than sign (<)</th> <td>188</td></tr>
+      	<tr><th>Less than sign (&lt;)</th> <td>188</td></tr>
       	<tr><th>Minus (-)</th> <td>189</td></tr>
       	<tr><th>Underscore (_)</th> <td>189</td></tr>
       	<tr><th>Period (.)</th> <td>190</td></tr>
-      	<tr><th>Greater than sign (>)</th> <td>190</td></tr>
+      	<tr><th>Greater than sign (&gt;)</th> <td>190</td></tr>
       	<tr><th>Question mark (?)</th> <td>191</td></tr>
       	<tr><th>Forward slash (/)</th> <td>191</td></tr>
       	<tr><th>Backtick (`)</th> <td>192</td></tr>
@@ -7092,7 +7074,7 @@
                 const unsigned short <a href="#events-DISPATCH_REQUEST_ERR">DISPATCH_REQUEST_ERR</a> = 1;
 
                 unsigned short code;
-}
+};
                 </code></pre>
               </dd>
       	        </dl>
@@ -7724,13 +7706,13 @@
           <dd><cite><a href="http://www.w3.org/TR/2006/REC-xml-20060816">Extensible Markup Language (XML) 1.0</a></cite>, T. Bray, J. Paoli, C. M. Sperberg-McQueen, et. al, Editors. World Wide Web Consortium, August 2006. This version of the XML 1.0 Recommendation is http://www.w3.org/TR/2006/REC-xml-20060816. The <a class="normative" href="http://www.w3.org/TR/xml">latest version of XML 1.0</a> is available at http://www.w3.org/TR/xml.</dd>
 
           <dt><strong>[<a id="references-DASE">DASE</a>]</strong></dt>
-          <dd><cite><a href="http://www.atsc.org/cms/standards/a100/a_100_2.pdf">ATSC A/100-2, DTV Application Software Environment Level 1 (DASE-1) Part 2: Declarative Applications and Environment.  Advanced Television Systems Committee, 09 March 2003. Available at <a href="http://www.atsc.org/cms/standards/a100/a_100_2.pdf">http://www.atsc.org/cms/standards/a100/a_100_2.pdf</a>.</dd>
+          <dd><cite><a href="http://www.atsc.org/cms/standards/a100/a_100_2.pdf">ATSC A/100-2, DTV Application Software Environment Level 1 (DASE-1) Part 2: Declarative Applications and Environment</a></cite>.  Advanced Television Systems Committee, 09 March 2003. Available at <a href="http://www.atsc.org/cms/standards/a100/a_100_2.pdf">http://www.atsc.org/cms/standards/a100/a_100_2.pdf</a>.</dd>
 
           <dt><strong>[<a id="references-OCAP">OCAP</a>]</strong></dt>
-          <dd><cite><a href="http://www.cablelabs.com/specifications/OC-SP-OCAP1.1.3-100603.pdf">Open Cable Application Platform 1.1.3.  Cable Television Laboratories, Inc., 03 June 2010. Available at <a href="http://www.cablelabs.com/specifications/OC-SP-OCAP1.1.3-100603.pdf">http://www.cablelabs.com/specifications/OC-SP-OCAP1.1.3-100603.pdf</a>.</dd>
+          <dd><cite><a href="http://www.cablelabs.com/specifications/OC-SP-OCAP1.1.3-100603.pdf">Open Cable Application Platform 1.1.3</a></cite>.  Cable Television Laboratories, Inc., 03 June 2010. Available at <a href="http://www.cablelabs.com/specifications/OC-SP-OCAP1.1.3-100603.pdf">http://www.cablelabs.com/specifications/OC-SP-OCAP1.1.3-100603.pdf</a>.</dd>
 
           <dt><strong>[<a id="references-WEB4CE">WEB4CE</a>]</strong></dt>
-          <dd><cite><a href="http://www.ce.org/Standards/browseByCommittee_2757.asp">ANSI/CEA-2014-B, Web-based Protocol and Framework for Remote User Interface on UPnPTM Networks and the Internet (Web4CE). Consumer Electronics Association, January 2011. Available at <a href="http://www.ce.org/Standards/browseByCommittee_2757.asp">http://www.ce.org/Standards/browseByCommittee_2757.asp</a>.</dd>
+          <dd><cite><a href="http://www.ce.org/Standards/browseByCommittee_2757.asp">ANSI/CEA-2014-B, Web-based Protocol and Framework for Remote User Interface on UPnPTM Networks and the Internet (Web4CE)</a></cite>. Consumer Electronics Association, January 2011. Available at <a href="http://www.ce.org/Standards/browseByCommittee_2757.asp">http://www.ce.org/Standards/browseByCommittee_2757.asp</a>.</dd>
         </dl>
       </div>
 <!-- div2 References-Informative -->