Warning, /utilities/konsole/data/keyboard-layouts/README-KeyTab is written in an unsupported language. File is not indexed.
0001 [README-KeyTab]
0002
0003 The keytabs shown in the Edit Profile dialog -> Keyboard tab are taken from
0004 *.keytab configuration files located in the system-wide location (typically
0005 /usr/share/applications/konsole on Linux) or the writable location in the
0006 user's home directory (typically ~/.local/share/applications/konsole on Linux).
0007
0008 Keytabs allow users to configure the behavior of konsole on keyboard events,
0009 especially functions keys. Have a look at doc/user/README.keyboard.
0010
0011 The syntax of each entry/rule follows the pattern:
0012
0013 "key" Keyname { ("+"|"-") Modename } ":" (String|Operation)
0014
0015 Key names are those defined in <qnamespace.h> with the "Qt::Key_" prefix
0016 removed. For a list of key names check the Qt::Key enum at:
0017 https://doc.qt.io/qt-5/qt.html#Key-enum
0018
0019 Mode names are:
0020
0021 - Shift : Shift Key pressed
0022 - Alt : Alt Key pressed
0023 - Control : Control Key pressed
0024
0025 ( The VT100 emulation has modes that can affect the sequences emitted
0026 by certain keys. Those modes are under control of the client program.
0027
0028 - Newline : affects Return and Enter keys, when set makes them send
0029 both \r and \n control characters; when reset makes them
0030 send \r only.
0031
0032 - Application : affects applications that use the Alternate Screen buffer.
0033
0034 - Ansi : send ANSI escape and control sequences (v.s. sending VT52
0035 escape and control sequences).
0036
0037 Since sending a state to a program that has set the state itself is
0038 positivly wrong and obsolete design, better forget about this nasty
0039 detail. I may well remove this "feature" in a future clean up round. )
0040
0041 A "+" preceding a Modename means the Key/mode is pressed/active respectively.
0042
0043 A "-" preceding a Modename means the Key/mode isn't pressed/active respectively.
0044
0045 If a mode isn't present in a key combination, its state is ignored.
0046
0047 Note that the combination of Key and Modes (set/reset) has to be unique.
0048 This means, that
0049
0050 key A + Shift : "A"
0051 key A : "a"
0052
0053 will not accept the small letter "a" rule as you'd exepct, you'll have
0054 to add a "- Shift" to the latter rule to make it work.
0055 Use the stdout/stderr dianostics of konsole when modifying keytabs to
0056 find problems like these.
0057
0058 Supported operations are
0059
0060 - scrollUpLine : scroll up one line in the history log
0061 - scrollUpPage : scroll up one page in the history log
0062 - scrollDownLine : scroll down one line in the history log
0063 - scrollDownPage : scroll down one page in the history log
0064 - scrollUpToTop : scroll up to the begining of the history log
0065 - scrollDownToBottom : scroll down to the end of the history log
0066
0067
0068 Strings have the syntax of C strings,
0069 one may use the following escapes:
0070
0071 - \E - Escape
0072 - \\ - Backslash
0073 - \" - Double quote
0074 - \t - Tab
0075 - \r - Carriage Return
0076 - \n - New Line
0077 - \b - Backspace
0078 - \xHH - where HH are two hex digits (e.g. \x00 (the NUL character))