summaryrefslogtreecommitdiffstats
path: root/konsole/other/README.KeyTab
diff options
context:
space:
mode:
authortoma <toma@283d02a7-25f6-0310-bc7c-ecb5cbfe19da>2009-11-25 17:56:58 +0000
committertoma <toma@283d02a7-25f6-0310-bc7c-ecb5cbfe19da>2009-11-25 17:56:58 +0000
commit4aed2c8219774f5d797760606b8489a92ddc5163 (patch)
tree3f8c130f7d269626bf6a9447407ef6c35954426a /konsole/other/README.KeyTab
downloadtdebase-4aed2c8219774f5d797760606b8489a92ddc5163.tar.gz
tdebase-4aed2c8219774f5d797760606b8489a92ddc5163.zip
Copy the KDE 3.5 branch to branches/trinity for new KDE 3.5 features.
BUG:215923 git-svn-id: svn://anonsvn.kde.org/home/kde/branches/trinity/kdebase@1054174 283d02a7-25f6-0310-bc7c-ecb5cbfe19da
Diffstat (limited to 'konsole/other/README.KeyTab')
-rw-r--r--konsole/other/README.KeyTab72
1 files changed, 72 insertions, 0 deletions
diff --git a/konsole/other/README.KeyTab b/konsole/other/README.KeyTab
new file mode 100644
index 000000000..4e94e5e50
--- /dev/null
+++ b/konsole/other/README.KeyTab
@@ -0,0 +1,72 @@
+[README.KeyTab]
+
+The keytabs offered in the Options/Keyboard menu are
+taken from from configurations files with a *.keytab
+pattern either located in $KDEDIR/share/apps/konsole
+or ~/.kde/share/apps/konsole.
+
+Keytabs allow to configure the behavior of konsole
+on keyboard events, especially for functions keys.
+Please have a look into the README.keyboard file, too.
+
+The syntax is that each entry has the form :
+
+ "key" Keyname { ("+"|"-") Modename } ":" (String|Operation)
+
+Keynames are those defined in <qnamespace.h> with the
+"Qt::Key_" prefix removed.
+
+Mode names are:
+
+ - Shift : Shift Key pressed
+ - Alt : Alt Key pressed
+ - Control : Control Key pressed
+
+ ( The VT100 emulation has modes that can affect the
+ sequences emitted by certain keys. These modes are
+ under control of the client program.
+
+ - Newline : effects Return and Enter key.
+ - Application : effects Up and Down key.
+ - Ansi : effects Up and Down key (This is for VT52, really).
+
+ Since sending a state to a program that has set the state
+ itself is positivly wrong and obsolete design, better forget
+ about this nasty detail. I may well remove this "feature"
+ in a future clean up round. )
+
+ A "+" preceeding a Modename means the Key is pressed.
+ A "-" preceeding a Modename means the Key is not pressed.
+ If no mode is given it means don't care.
+
+ Note that the combination of Key and Modes (set/reset)
+ has to be unique. This means, that
+
+ key A + Shift : "A"
+ key A : "a"
+
+ will not accept the small letter "a" rule as expected,
+ one has to add a "- Shift" to the last clause. Use
+ the stdout/stderr dianostics of konsole when modifying
+ keytabs to find problems like this.
+
+Operations are
+
+ - scrollUpLine : scroll up one line in the history log
+ - scrollUpPage : scroll up one page in the history log
+ - scrollDownLine : scroll down one line in the history log
+ - scrollDownPage : scroll down one page in the history log
+ - emitClipboard : "paste" the current clipboard
+ - emitSelection : "paste" the current selection
+
+Strings have the syntax of C strings,
+one may use the following escapes:
+
+ - \E - escape
+ - \\ - backslash
+ - \" - double quote
+ - \t - tab
+ - \r - return
+ - \n - newline
+ - \b - backspace
+ - \xHH - where HH are two hex digits