From 8970c7ea1801032ffc44919dca5e4faef77449a6 Mon Sep 17 00:00:00 2001 From: Daniel Eklöf Date: Wed, 11 Nov 2020 18:37:28 +0100 Subject: readme/doc:foot.1: document the (new) keypad behavior --- README.md | 20 ++++++++++++++++++++ 1 file changed, 20 insertions(+) (limited to 'README.md') diff --git a/README.md b/README.md index 0d4ce17c..7cc055ac 100644 --- a/README.md +++ b/README.md @@ -18,6 +18,7 @@ The fast, lightweight and minimalistic Wayland terminal emulator. 1. [Server (daemon) mode](#server-daemon-mode) 1. [Alt/meta](#alt-meta) 1. [Backspace](#backspace) +1. [Keypad](#keypad) 1. [DPI and font size](#dpi-and-font-size) 1. [Supported OSCs](#supported-oscs) 1. [Programmatically checking if running in foot](#programmatically-checking-if-running-in-foot) @@ -263,6 +264,25 @@ Finally, pressing alt will prefix the transmitted byte with ESC. +## KEYPAD + +By default, Num Lock overrides the run-time configuration +keypad mode; when active, the keypad is always considered to be in +_numerical_ mode. This corresponds to XTerm's `numLock` option set to +`true`. + +In this mode, the keypad keys always sends either numbers (Num +Lock is **active**) or cursor movement keys (Up, +Down, Left, Right, Page +Up, Page Down etc). + +This can be disabled programmatically with `\E[?1035l` (and enabled +again with `\E[?1035h`). + +When disabled, the keypad sends custom escape sequences instead of +numbers, when in _application_ mode. + + ## DPI and font size Font sizes are apparently a complex thing. Many applications use a -- cgit v1.3