From f6fb370b1bcc5f87c72b14c5eb4f29521ab06163 Mon Sep 17 00:00:00 2001
From: Olivier G-R <olivier@fractalwire.io>
Date: Tue, 26 Mar 2019 20:44:59 +0100
Subject: keymap: add more (keypad) keycodes #9793

- K_KORIGIN instead of K_KCENTER: This name is similar to what is used
  by xev. Alternative could be K_KBEGIN as hinted here:
  https://invisible-island.net/xterm/ctlseqs/ctlseqs.html#h2-PC-Style-Function-Keys
  But I find Begin and Home too similar, and it might induced some
  confusion. The naming looked related to some old keyboard
  configuration.

- keymap.c: alias KPPeriod to kDel instead of kPoint.
  This might seems weird, but this is actually the behaviour that should
  be expected. libtermkey produces "KPPeriod" when num lock is off. To
  fix this would need to change this name in termkey.

closes #9780
closes #9793
---
 runtime/doc/intro.txt | 9 +++++++++
 1 file changed, 9 insertions(+)

(limited to 'runtime')

diff --git a/runtime/doc/intro.txt b/runtime/doc/intro.txt
index fee7d9aa69..86a6136d32 100644
--- a/runtime/doc/intro.txt
+++ b/runtime/doc/intro.txt
@@ -359,10 +359,16 @@ notation	meaning		    equivalent	decimal value(s)	~
 <End>		end				*end*
 <PageUp>	page-up				*page_up* *page-up*
 <PageDown>	page-down			*page_down* *page-down*
+<kUp>		keypad cursor-up		*keypad-cursor-up*
+<kDown>		keypad cursor-down		*keypad-cursor-down*
+<kLeft>		keypad cursor-left		*keypad-cursor-left*
+<kRight>	keypad cursor-right		*keypad-cursor-right*
 <kHome>		keypad home (upper left)	*keypad-home*
 <kEnd>		keypad end (lower left)		*keypad-end*
+<kOrigin>	keypad origin (middle)		*keypad-origin*
 <kPageUp>	keypad page-up (upper right)	*keypad-page-up*
 <kPageDown>	keypad page-down (lower right)	*keypad-page-down*
+<kDel>		keypad delete 			*keypad-delete*
 <kPlus>		keypad +			*keypad-plus*
 <kMinus>	keypad -			*keypad-minus*
 <kMultiply>	keypad *			*keypad-multiply*
@@ -392,6 +398,9 @@ recognized as the non-keypad code.  For example, when <kHome> sends the same
 code as <Home>, when pressing <kHome> Vim will think <Home> was pressed.
 Mapping <kHome> will not work then.
 
+Note: If numlock is on, the |TUI| receives plain ASCII values, so
+mappings to <k0> - <k9> and <kPoint> will not work.
+
 								*<>*
 Examples are often given in the <> notation.  Sometimes this is just to make
 clear what you need to type, but often it can be typed literally, e.g., with
-- 
cgit