mirrors/foot
1
0
Fork 0
mirror of https://codeberg.org/dnkl/foot.git synced 2026-03-02 01:40:13 -05:00
Code Issues Projects Releases Packages Wiki Activity Actions

readme/doc:foot.1: document the (new) keypad behavior

Browse source
This commit is contained in:
Daniel Eklöf 2020-11-11 18:37:28 +01:00
parent dea8e89fda
commit 8970c7ea18
No known key found for this signature in database
GPG key ID: 5BBD4992C116573F
4 changed files with 44 additions and 1 deletions
Download patch file Download diff file Expand all files Collapse all files

7
CHANGELOG.md
View file

@ -19,6 +19,13 @@
## 1.5.4 ## 1.5.4
### Changed
* Num Lock by default overrides the keypad mode. See
**foot.ini**(5)::KEYPAD, or [README.md](README.md#keypad) for
details (https://codeberg.org/dnkl/foot/issues/194).
### Fixed ### Fixed
* Resize very slow when window is hidden * Resize very slow when window is hidden

20
README.md
View file

@ -18,6 +18,7 @@ The fast, lightweight and minimalistic Wayland terminal emulator.
1. [Server (daemon) mode](#server-daemon-mode) 1. [Server (daemon) mode](#server-daemon-mode)
1. [Alt/meta](#alt-meta) 1. [Alt/meta](#alt-meta)
1. [Backspace](#backspace) 1. [Backspace](#backspace)
1. [Keypad](#keypad)
1. [DPI and font size](#dpi-and-font-size) 1. [DPI and font size](#dpi-and-font-size)
1. [Supported OSCs](#supported-oscs) 1. [Supported OSCs](#supported-oscs)
1. [Programmatically checking if running in foot](#programmatically-checking-if-running-in-foot) 1. [Programmatically checking if running in foot](#programmatically-checking-if-running-in-foot)
@ -263,6 +264,25 @@ Finally, pressing <kbd>alt</kbd> will prefix the transmitted byte with
ESC. ESC.
## KEYPAD
By default, <kbd>Num Lock</kbd> 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 (<kbd>Num
Lock</kbd> is **active**) or cursor movement keys (<kbd>Up</kbd>,
<kbd>Down</kbd>, <kbd>Left</kbd>, <kbd>Right</kbd>, <kbd>Page
Up</kbd>, <kbd>Page Down</kbd> 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 ## DPI and font size
Font sizes are apparently a complex thing. Many applications use a Font sizes are apparently a complex thing. Many applications use a

17
doc/foot.1.scd
View file

@ -261,6 +261,23 @@ described above *cannot* be changed.
Finally, pressing *alt* will prefix the transmitted byte with ESC. 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 # CONFIGURATION
See *foot.ini*(5) See *foot.ini*(5)

1
foot.ini
View file

@ -79,7 +79,6 @@
# pipe-scrollback=[sh -c "xurls | bemenu | xargs -r firefox"] none # pipe-scrollback=[sh -c "xurls | bemenu | xargs -r firefox"] none
# pipe-selected=[xargs -r firefox] none # pipe-selected=[xargs -r firefox] none
[search-bindings] [search-bindings]
# cancel=Control+g Escape # cancel=Control+g Escape
# commit=Return # commit=Return