Fix 23906: Add definition for virtual modifier key 'Accel'
authorGary Kacmarcik <garykac@google.com>
Tue, 06 May 2014 14:42:39 -0700
changeset 620 b722b0972b93
parent 619 1b16eb00ac6c
child 621 14b8c9f6caa0
Fix 23906: Add definition for virtual modifier key 'Accel'
html/DOM3-Events.html
html/DOM3Events-key.html
--- a/html/DOM3-Events.html	Mon May 05 17:50:52 2014 -0700
+++ b/html/DOM3-Events.html	Tue May 06 14:42:39 2014 -0700
@@ -2813,7 +2813,7 @@
 							<p class="intro-dom">Introduced in DOM Level 3</p>
 
 							<p>Queries the state of a modifier using a key value.
-								See also <a href="#keys-modifiers">Modifier keys</a>.
+								See <a href="#keys-modifiers">Modifier keys</a> for a list of valid arguments to this method.
 								</p>
 
 							<p>Returns <code>true</code> if it is a modifier key and the modifier is activated,
@@ -4858,13 +4858,15 @@
 
 						<dt>boolean getModifierState()</dt>
 						<dd>
-							<p>Queries the state of a modifier using a key value. See also <a href="#keys-modifiers">Modifier keys</a>.</p>
+							<p>Queries the state of a modifier using a key value.
+								See <a href="#keys-modifiers">Modifier keys</a> for a list of valid arguments to this method.
+								</p>
 
 							<dl class="parameters">
 								<dt>DOMString keyArg</dt>
 								<dd>
 									<p>A modifier key value.  Valid modifier keys are defined in the
-										<a href="#key-table-modifier">Modifier Keys</a> table in
+										<a href="DOM3Events-key.html#keys-modifier">Modifier Keys</a> table in
 										[<a href="#references-D3E-key">DOM3 key Values</a>].
 										</p>
 
--- a/html/DOM3Events-key.html	Mon May 05 17:50:52 2014 -0700
+++ b/html/DOM3Events-key.html	Tue May 06 14:42:39 2014 -0700
@@ -167,6 +167,20 @@
 		<section id="keys-modifier">
 			<h4>Modifier Keys</h4>
 			<div id="key-table-modifier" class="key-table">
+				<key name="Accel">This is a virtual modifier key that is equivalent to whichever key the current OS uses
+					as the menu "accelerator" key. This virtual modifier key is never set by itself - it is always set in
+					conjunction with one of the other modifier keys in this list.
+					<p>For Windows, this virtual key is equivalent to the <code>'OS'</code> key.
+						</p>
+					<p>For Mac OS, this key is equivalent to the <code>'Meta'</code> key.
+						Although note that the <code>'Meta'</code> key on other platforms SHOULD NOT be associated
+						with the <code>'Accel'</code>.
+						</p>
+					<p>For Linux, it is equivalent to the <code>'Super'</code> and <code>'Hyper'</code> keys
+						(so if either of these modifier keys is pressed, then the <code>'Accel'</code> modifier key
+						is considered to be pressed).
+						</p>
+					</key>
 				<key name="Alt">The Alternative (Alt, Option, Menu) key.  Enable alternate modifier function for interpreting concurrent or subsequent keyboard input.
 					This key value is also used for the Apple <code>'Option'</code> key.
 					</key>