Update userguide

This commit is contained in:
autonielx
2014-04-05 18:48:32 +02:00
parent 1dc78b8c1e
commit e795d95872
636 changed files with 6411 additions and 3537 deletions
+8 -4
View File
@@ -4,7 +4,7 @@
<head>
<!--
*
* Copyright 2008-2009, Haiku. All rights reserved.
* Copyright 2008-20014, Haiku. All rights reserved.
* Distributed under the terms of the MIT License.
*
* Authors:
@@ -73,8 +73,12 @@ Thus, the Keymap preferences are not only for configuring your local keymap, but
<tr><td><span class="menu">Select dead keys</span></td><td> </td><td>for setting the above mentioned blue keys.</td></tr>
<tr><td class="onelinetop"><span class="menu">Switch shortcut key...</span></td><td> </td><td>for using the shortcut key in Windows/Linux mode, i.e. <span class="key">CONTROL</span> (normally <span class="key">CTRL</span>) or Haiku mode, i.e. <span class="key">COMMAND</span> (normally <span class="key">ALT</span>).</td></tr>
</table>
<p>The lists on the left offer the available pre-configured keymaps of the system, and below that, if available, user-defined maps. You can change a keymap via drag&amp;drop in the keyboard representation: a left-click-drag copies a key, a right-click-drag exchanges the two keys.<br />
When you're done you can save the result from the menu <span class="menu">File | Save...</span>. Your modified map will only appear in the user-defined list if it's stored in <span class="path">~/config/settings/Keymap/</span>. Otherwise you'll have to manually load it via <span class="menu">File | Open...</span>.</p>
<p>The lists on the left offer the available pre-configured keymaps of the system, and below that, if available, user-defined maps. You can change a keymap via drag&amp;drop in the keyboard representation: a left-click-drag copies a key, a right-click-drag exchanges the two keys.</p>
<p>Alternatively to this drag&amp;dropping of keys, there's the menu <span class="menu">File | Set modifier keys...</span> that opens this window:</p>
<img src="../images/prefs-images/keymap-modifiers.png" alt="keymap-modifiers.png" />
<p>Here, you can assign keys to their respective roles or even completely disable the role of a key. You can even assign the same key to different roles, though that's not a good idea most of the time and you'll be warned by a small exclamation mark beside the pop-up menus if you do that.<br />
Pressing <span class="button">Set modifier keys</span> applies your changes and closes the window.</p>
<p>When you're done you can save the result from the menu <span class="menu">File | Save...</span>. Your modified map will only appear in the user-defined list if it's stored in <span class="path">~/config/settings/Keymap/</span>. Otherwise you'll have to manually load it via <span class="menu">File | Open...</span>.</p>
<p>To better match the Keymap panel to your physical keyboard, there are several different settings available from the <span class="menu">Layout</span> menu.</p>
<p>The font used in the keyboard representation is set from the <span class="menu">Font</span> menu. Note, that it may or may not contain all symbols for a specific keymap.</p>
<p>Finally, there's a <span class="button">Revert</span> button to bring back the settings that were active when you started the Keymap preferences.</p>
@@ -86,7 +90,7 @@ When you're done you can save the result from the menu <span class="menu">File |
<p>You can dump the current keymap with a command in Terminal:</p>
<pre class="terminal">keymap -d &gt; MyKeymap</pre>
<p>The generated text file can then be opened in a text editor. Make sure to use a fixed font in that editor or you'll never grok that file...<br />
At the beginning of that file, you'll find a legend of a stylized keyboard with the hex value corresponding to each key. Below that are the actual assignments of every value. You can do all the customizing that's also available from the Keymap preference panel, and then some. If you happen to have some special keys on your keyboard, you may be able to activate them. That is, use them as ordinary keys or like an option or control key. You won't be able to, for example, have your multimedia keys de/increase the volume or start some application. For this you can use e.g. <a href="http://www.haikuware.com/directory/view-details/utilities/desktop-accessories/spicykeys" class="noprinturl">SpicyKeys</a>.</p>
At the beginning of that file, you'll find a legend of a stylized keyboard with the hex value corresponding to each key. Below that are the actual assignments of every value. You can do all the customizing that's also available from the Keymap preference panel, and then some. If you happen to have some special keys on your keyboard, you may be able to activate them. That is, use them as ordinary keys or like an option or control key. You won't be able to, for example, have your multimedia keys de/increase the volume or start some application. For this you can use the <a href="shortcuts.html">Shortcuts</a> preferences.</p>
<p>When you're finished, you'll save the file and have your system load the modified keymap with this command:</p>
<pre class="terminal">keymap -s &lt; MyKeymap</pre>
<p>If you'd like to import this keymap into the Keymap panel, you have to compile it first to a binary format:</p>