Change location of Alt/AltGr to be left/right instead of standard.
Add note that Fn is a hardware key.
--- 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 -->