Change location of Alt/AltGr to be left/right instead of standard.
authorGary Kacmarcik <garykac@google.com>
Sun, 24 Feb 2013 18:41:32 -0800
changeset 27 6e2e3fa1caf8
parent 26 4003c4001492
child 28 2484dd2a5855
child 29 65b4ce948b99
Change location of Alt/AltGr to be left/right instead of standard.
Add note that Fn is a hardware key.
source_respec.htm
--- a/source_respec.htm	Sun Feb 24 08:22:35 2013 -0800
+++ b/source_respec.htm	Sun Feb 24 18:41:32 2013 -0800
@@ -580,15 +580,16 @@
                     <thead><tr><th>Keyboard Layout</th><th><code>char</code></th><th><code>key</code></th><th><code>code</code></th><th>Notes</th></tr></thead>
                     <tbody>
                         <tr><td>US</td><td><code class="glyph">''</code></td><td><code class="key-code">'Alt'</code></td><td><code class="key-code">'AltLeft'</code></td><td><code class="constant-name">DOM_KEY_LOCATION_LEFT</code></td></tr>
-                        <tr><td>French</td><td><code class="glyph">''</code></td><td><code class="key-code">'Alt'</code></td><td><code class="key-code">'AltLeft'</code></td><td><code class="constant-name">DOM_KEY_LOCATION_STANDARD</code></td></tr>
+                        <tr><td>French</td><td><code class="glyph">''</code></td><td><code class="key-code">'Alt'</code></td><td><code class="key-code">'AltLeft'</code></td><td><code class="constant-name">DOM_KEY_LOCATION_LEFT</code></td></tr>
                         <tr><td>US</td><td><code class="glyph">''</code></td><td><code class="key-code">'Alt'</code></td><td><code class="key-code">'AltRight'</code></td><td><code class="constant-name">DOM_KEY_LOCATION_RIGHT</code></td></tr>
-                        <tr><td>French</td><td><code class="glyph">''</code></td><td><code class="key-code">'AltGr'</code></td><td><code class="key-code">'AltRight'</code></td><td><code class="constant-name">DOM_KEY_LOCATION_STANDARD</code></td></tr>
+                        <tr><td>French</td><td><code class="glyph">''</code></td><td><code class="key-code">'AltGr'</code></td><td><code class="key-code">'AltRight'</code></td><td><code class="constant-name">DOM_KEY_LOCATION_RIGHT</code></td></tr>
                     </tbody>
                 </table><p class="example-text">
                    In this example, checking the <code>key</code> attribute permits matching <code class="key-code">'Alt'</code> without worrying about which Alt key (left or right) was pressed.
                    Checking the <code>code</code> attribute permits matching the right Alt key (<code class="key-code">'AltRight'</code>) without worrying about which layout is currently in effect.
-                </p><p class="example-text">Note that, with the French layout, the location for the Alt and AltGr keys is <code class="constant-name">DOM_KEY_LOCATION_STANDARD</code> since there
-                   is only one of each key. 
+                </p><p class="example-text">Note that, in the French example, the <code class="key-code">'Alt'</code> and
+                   <code class="key-code">'AltGr'</code> keys retain their left and right location, even through there
+                   is only one of each key.
                 </p>
             </pre><!-- Handling Left and Right Alt Keys -->
 
@@ -1214,9 +1215,9 @@
                                 <td>0x44</td><td></td></tr>
                             <tr><td><code id="code-F12" class="key-code">'F12'</code></td>
                                 <td>0x45</td><td></td></tr>
-                            <tr><td><code id="code-F12" class="key-code">'Fn'</code></td>
-                                <td></td><td>Not typically located in the Function section, but included here to keep with related keys.</td></tr>
-                            <tr><td><code id="code-F12" class="key-code">'FLock'</code></td>
+                            <tr><td><code id="code-Fn" class="key-code">'Fn'</code></td>
+                                <td></td><td>This is typically a hardware key that does not generate a separate code. Most keyboards do not place this key in the Function section, but it is included here to keep with related keys.</td></tr>
+                            <tr><td><code id="code-FLock" class="key-code">'FLock'</code></td>
                                 <td></td><td>Found on the Microsoft Natural Keyboard.</td></tr>
                             <tr><td><code id="code-Power" class="key-code">'Power'</code></td>
                                 <td></td><td>Found on some Apple keyboards (replacing the <code class="key-code">'Eject'</code> key).</td></tr>
@@ -1368,11 +1369,9 @@
 
             <section id="virtual-keyboards">
                 <h1>Virtual Keyboards</h1>
-                <p>When a virtual keyboard is trying mimicking the layout and functionality of a standard
+                <p>When a virtual keyboard is mimicking the layout and functionality of a standard
                    keyboard, then it should also set the <code>code</code> attribute as appropriate.
-                   However, most virtual keyboards only copy the layout of the core writing system keys.
-                   Virtual keyboards that fall into this category can safely ignore the <code>code</code>
-                   attribute (by leaving is empty).
+                   Otherwise, it can leave this field blank.
                 </p>
             </section><!-- virtual-keyboards -->