| 1 | [README.KeyTab] |
|---|
| 2 | |
|---|
| 3 | The keytabs offered in the Options/Keyboard menu are |
|---|
| 4 | taken from from configurations files with a *.keytab |
|---|
| 5 | pattern either located in $KDEDIR/share/apps/konsole |
|---|
| 6 | or ~/.kde/share/apps/konsole. |
|---|
| 7 | |
|---|
| 8 | Keytabs allow to configure the behavior of konsole |
|---|
| 9 | on keyboard events, especially for functions keys. |
|---|
| 10 | Please have a look into the README.keyboard file, too. |
|---|
| 11 | |
|---|
| 12 | The syntax is that each entry has the form : |
|---|
| 13 | |
|---|
| 14 | "key" Keyname { ("+"|"-") Modename } ":" (String|Operation) |
|---|
| 15 | |
|---|
| 16 | Keynames are those defined in <qnamespace.h> with the |
|---|
| 17 | "Qt::Key_" prefix removed. |
|---|
| 18 | |
|---|
| 19 | Mode names are: |
|---|
| 20 | |
|---|
| 21 | - Shift : Shift Key pressed |
|---|
| 22 | - Alt : Alt Key pressed |
|---|
| 23 | - Control : Control Key pressed |
|---|
| 24 | |
|---|
| 25 | ( The VT100 emulation has modes that can affect the |
|---|
| 26 | sequences emitted by certain keys. These modes are |
|---|
| 27 | under control of the client program. |
|---|
| 28 | |
|---|
| 29 | - Newline : effects Return and Enter key. |
|---|
| 30 | - Application : effects Up and Down key. |
|---|
| 31 | - Ansi : effects Up and Down key (This is for VT52, really). |
|---|
| 32 | |
|---|
| 33 | Since sending a state to a program that has set the state |
|---|
| 34 | itself is positivly wrong and obsolete design, better forget |
|---|
| 35 | about this nasty detail. I may well remove this "feature" |
|---|
| 36 | in a future clean up round. ) |
|---|
| 37 | |
|---|
| 38 | A "+" preceding a Modename means the Key is pressed. |
|---|
| 39 | A "-" preceding a Modename means the Key is not pressed. |
|---|
| 40 | If no mode is given it means don't care. |
|---|
| 41 | |
|---|
| 42 | Note that the combination of Key and Modes (set/reset) |
|---|
| 43 | has to be unique. This means, that |
|---|
| 44 | |
|---|
| 45 | key A + Shift : "A" |
|---|
| 46 | key A : "a" |
|---|
| 47 | |
|---|
| 48 | will not accept the small letter "a" rule as expected, |
|---|
| 49 | one has to add a "- Shift" to the last clause. Use |
|---|
| 50 | the stdout/stderr diagnostics of konsole when modifying |
|---|
| 51 | keytabs to find problems like this. |
|---|
| 52 | |
|---|
| 53 | Operations are |
|---|
| 54 | |
|---|
| 55 | - scrollUpLine : scroll up one line in the history log |
|---|
| 56 | - scrollUpPage : scroll up one page in the history log |
|---|
| 57 | - scrollDownLine : scroll down one line in the history log |
|---|
| 58 | - scrollDownPage : scroll down one page in the history log |
|---|
| 59 | - emitClipboard : "paste" the current clipboard |
|---|
| 60 | - emitSelection : "paste" the current selection |
|---|
| 61 | |
|---|
| 62 | Strings have the syntax of C strings, |
|---|
| 63 | one may use the following escapes: |
|---|
| 64 | |
|---|
| 65 | - \E - escape |
|---|
| 66 | - \\ - backslash |
|---|
| 67 | - \" - double quote |
|---|
| 68 | - \t - tab |
|---|
| 69 | - \r - return |
|---|
| 70 | - \n - newline |
|---|
| 71 | - \b - backspace |
|---|
| 72 | - \xHH - where HH are two hex digits |
|---|
