← Back to branch summary

~verzegnassi-stefano/+junk/ubuntu-terminal-app-uitk13

« back to all changes in this revision

Viewing changes to src/plugin/qmltermwidget/qtermwidget/lib/kb-layouts/README

  • Committer: Filippo Scognamiglio
  • Date: 2014-10-25 04:42:31 UTC
  • Revision ID: flscogna@gmail.com-20141025044231-javjhusbqa171127
Initial reboot commit.

Show diffs side-by-side

added added

removed removed

Lines of Context:
src/plugin/qmltermwidget/qtermwidget/lib/kb-layouts/README
 
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 "+" preceeding a Modename means the Key is pressed.
 
39
  A "-" preceeding 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 dianostics 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