Fix 23908: Cleanup text describing how key values should be assigned (based on comments).
authorGary Kacmarcik <garykac@google.com>
Mon, 12 May 2014 16:24:31 -0700
changeset 630 24681f257c42
parent 629 096785db6165
child 631 121807b7996b
Fix 23908: Cleanup text describing how key values should be assigned (based on comments).
html/DOM3-Events.html
--- a/html/DOM3-Events.html	Mon May 12 16:12:23 2014 -0700
+++ b/html/DOM3-Events.html	Mon May 12 16:24:31 2014 -0700
@@ -7762,10 +7762,7 @@
 
 				<p><strong>This section is normative.</strong></p>
 
-				<p>To determine the appropriate key values for a key, the user agent needs to
-					consider the current function of the key (including modifiers), taking
-					into account the current keyboard layout, when determining
-					the appropriate <em>key value</em> to use.
+				<p>To determine the appropriate key value for a key, use the following algorithm:
 					</p>
 
 				<ol class="algo" id="key-algorithm">
@@ -7781,13 +7778,13 @@
 							<a href="#widl-KeyboardEvent-key"><code>KeyboardEvent.key</code></a>
 						attribute MUST be a string consisting of the <em>char value</em> of that character.
 						</li>
-					<li>If the key combination includes one or more modifier keys that result in the key
-						no longer producing a printable character (e.g., 'Control' + 'a'),
+					<li>If more than one key is being pressed and the key combination includes one or more modifier keys that result in the key
+						no longer producing a printable character (e.g., <code class="key">'Control'</code> + <code class="key">'a'</code>),
 						then the key value should be the printable key value that would have been 
 						produced if the key had been typed with the default keyboard layout
-						with no modifier keys except for 'Shift' and 'AltGr' applied.
+						with no modifier keys except for <code class="key">'Shift'</code> and <code class="key">'AltGr'</code> applied.
 						</li>
-					<li>Otherwise, the special value <code>'Unidentified'</code> should be used.
+					<li>Otherwise, the special value <code class="key">'Unidentified'</code> should be used.
 						</li>
 				</ol>
 
@@ -7810,8 +7807,8 @@
 							attribute value for the unmodified key will be <code class="key">'5'</code>.
 							</li>
 						<li>On the same US Dvorak keyboard layout as the previous example,
-							pressing 'Control' and the key labeled <code class="glyph">'Q'</code>
-							will produce a key value of 'q'.
+							pressing <code class="key">'Control'</code> and the key labeled <code class="glyph">'Q'</code>
+							will produce a key value of <code class="key">'q'</code>.
 							</li>
 						<li>On a French PC keyboard with a standard French mapping, the primary function of the
 								<code class="glyph">'^'</code>