diff options
| author | Daniel Eklöf <daniel@ekloef.se> | 2020-02-21 18:11:03 +0000 |
|---|---|---|
| committer | Daniel Eklöf <daniel@ekloef.se> | 2020-02-21 18:11:03 +0000 |
| commit | ae23023341db2dc121f934dfe21e724d527da134 (patch) | |
| tree | 69c25fc39beede752a99d753dfa1a0861284b56c | |
| parent | client: make sure 'cwd' is in scope of all goto's (diff) | |
keymap: align backspace escapes with XTerm
Backspace now emits DEL for all non-ctrl modifier combos, and BS for
all ctrl modifier combos.
The alt modifier prefixes DEL/BS with ESC.
This also removes my own hack of mapping ctrl+backspace to
alt+backspace.
Describe backspace behavior in both the README and the man page.
TODO: implement DECBKM to allow applications to toggle the backspace
behavior.
| -rw-r--r-- | README.md | 17 | ||||
| -rw-r--r-- | doc/foot.1.scd | 11 | ||||
| -rw-r--r-- | keymap.h | 19 |
3 files changed, 44 insertions, 3 deletions
@@ -15,6 +15,7 @@ 1. [Mouse](#mouse) 1. [Server (daemon) mode](#server-daemon-mode) 1. [Alt/meta](#alt-meta) +1. [Backspace](#backspace) 1. [DPI and font size](#dpi-and-font-size) 1. [Requirements](#requirements) 1. [Running](#running) @@ -220,6 +221,22 @@ mode_, `\E[?1034l`), and enabled again with `smm` (_set meta mode_, '\E[?1034h`). +## Backspace + +Foot transmits DEL (`^?`) on <kbd>backspace</kbd>. This corresponds to +XTerm's `backarrowKey` option set to `false`, and to DECBKM being +_reset_. + +To instead transmit BS (`^H`), press +<kbd>ctrl</kbd>+<kbd>backspace</kbd>. + +Note that foot does **not** implement DECBKM, and that the behavior +described above **cannot** be changed. + +Finally, pressing <kbd>alt</kbd> will prefix the transmitted byte with +ESC. + + ## DPI and font size Font sizes are apparently a complex thing. Many applications use a diff --git a/doc/foot.1.scd b/doc/foot.1.scd index fcd9d1f8..8b5268b7 100644 --- a/doc/foot.1.scd +++ b/doc/foot.1.scd @@ -199,6 +199,17 @@ This can also be disabled programatically with *rmm* (Reset Meta Mode, *\E[?1034l*), and enabled again with *smm* (Set Meta Mode, *\E[?1034h*). +# BACKSPACE + +Foot transmits DEL (*^?*) on backspace. This corresponds to XTerm's +*backarrowKey* option set to *false*, and to DECBKM being _reset_. + +To instead transmit BS (*^H*), press *ctrl*+*backspace*. + +Note that foot does *not* implement DECBKM, and that the behavior +described above *cannot* be changed. + +Finally, pressing *alt* will prefix the transmitted byte with ESC. # CONFIGURATION @@ -38,9 +38,22 @@ static const struct key_data key_backtab[] = { }; static const struct key_data key_backspace[] = { - {MOD_ALT, CURSOR_KEYS_DONTCARE, KEYPAD_DONTCARE, "\033\x7f"}, - {MOD_CTRL, CURSOR_KEYS_DONTCARE, KEYPAD_DONTCARE, "\033\x7f"}, - {MOD_ANY, CURSOR_KEYS_DONTCARE, KEYPAD_DONTCARE, "\x7f"}, + {MOD_SHIFT, CURSOR_KEYS_DONTCARE, KEYPAD_DONTCARE, "\x7f"}, + {MOD_ALT, CURSOR_KEYS_DONTCARE, KEYPAD_DONTCARE, "\033\x7f"}, + {MOD_SHIFT | MOD_ALT, CURSOR_KEYS_DONTCARE, KEYPAD_DONTCARE, "\033\x7f"}, + {MOD_CTRL, CURSOR_KEYS_DONTCARE, KEYPAD_DONTCARE, "\x08"}, + {MOD_SHIFT | MOD_CTRL, CURSOR_KEYS_DONTCARE, KEYPAD_DONTCARE, "\x08"}, + {MOD_ALT | MOD_CTRL, CURSOR_KEYS_DONTCARE, KEYPAD_DONTCARE, "\033\x08"}, + {MOD_SHIFT | MOD_ALT | MOD_CTRL, CURSOR_KEYS_DONTCARE, KEYPAD_DONTCARE, "\033\x08"}, + {MOD_META, CURSOR_KEYS_DONTCARE, KEYPAD_DONTCARE, "\x7f"}, + {MOD_META | MOD_SHIFT, CURSOR_KEYS_DONTCARE, KEYPAD_DONTCARE, "\x7f"}, + {MOD_META | MOD_ALT, CURSOR_KEYS_DONTCARE, KEYPAD_DONTCARE, "\033\x7f"}, + {MOD_META | MOD_SHIFT | MOD_ALT, CURSOR_KEYS_DONTCARE, KEYPAD_DONTCARE, "\033\x7f"}, + {MOD_META | MOD_CTRL, CURSOR_KEYS_DONTCARE, KEYPAD_DONTCARE, "\x08"}, + {MOD_META | MOD_SHIFT | MOD_CTRL, CURSOR_KEYS_DONTCARE, KEYPAD_DONTCARE, "\x08"}, + {MOD_META | MOD_ALT | MOD_CTRL, CURSOR_KEYS_DONTCARE, KEYPAD_DONTCARE, "\033\x08"}, + {MOD_META | MOD_SHIFT | MOD_ALT | MOD_CTRL, CURSOR_KEYS_DONTCARE, KEYPAD_DONTCARE, "\033\x08"}, + {MOD_ANY, CURSOR_KEYS_DONTCARE, KEYPAD_DONTCARE, "\x7f"}, }; #define DEFAULT_MODS_FOR_SINGLE(sym) \ |
