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 --- doc/foot.1.scd | 17 +++++++++++++++++ 1 file changed, 17 insertions(+) (limited to 'doc') diff --git a/doc/foot.1.scd b/doc/foot.1.scd index 20ac9ebc..7e61d7a7 100644 --- a/doc/foot.1.scd +++ b/doc/foot.1.scd @@ -261,6 +261,23 @@ described above *cannot* be changed. 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. + # CONFIGURATION See *foot.ini*(5) -- cgit v1.3