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

1 files changed, 44 insertions, 0 deletions

diff --git a/konsole/README.keyboard b/konsole/README.keyboard
new file mode 100644
index 000000000..93a0ac20f
--- /dev/null
+++ b/konsole/README.keyboard
@@ -0,0 +1,44 @@
+[README.keyboard]
+
+The *.keytab files (located in $KDEDIR/share/apps/konsole) allow
+to configure the keyboard due to your specific environment.
+
+Beside that you can use them to make the keyboard emit virtually
+any escape sequence you want, here a probe of more typical problems
+related to keyboards, that can be coped with this way:
+
+- BS Hack
+
+  While one would expect, that the Backspace key send Ascii
+  Backspace, this is not the case in many Linux installations.
+
+  The idea behind this hack is to preserve the CTRL-H.
+
+  So the mapping is:
+
+    CTRL-H    -> 0x08
+    Backspace -> 0x7f
+    Delete    -> \E[3~
+
+- Home/End Keys
+
+    Home     -> \E[1~
+    End      -> \E[4~
+
+  or
+
+    Home     -> \E[H
+    End      -> \E[F
+
+Quite a lot of those key sequences are floating around.
+
+Consult your terminfo or termcap database for the expected values.
+Note that your system is not unlikely to have other keyboard databases
+which have to be in sync, too (e.g. /etc/inputrc for readline(3)).
+
+If you want to adjust things to your needs, copy one of the
+*.keytab files and edit it. When restarted, konsole offeres
+you this new entry on it's menu.
+
+In case your new keytab is likely to suit common needs,
+please contribute to konsole by sending me the file.