Improve docs for legacy modes

This commit is contained in:
Oliver Blanthorn 2026-07-05 12:17:16 +02:00
parent 468223cb39
commit fac4885cc7
No known key found for this signature in database
GPG key ID: 2BB8C36BB504BFF3

View file

@ -4421,7 +4421,7 @@ export function comclear(name: string) {
Modifiers are truncated to a single character, so Ctrl -> C, Alt -> A, and Shift -> S. Shift is a bit special as it is only required if Shift does not change the key inputted, e.g. `<S-ArrowDown>` is OK, but `<S-a>` should just be `A`.
Additionally, you can bind explicitly to a keydown or keyup event with the `D` and `U` modifiers respectively. You can make any bind optional by giving it a `?` modifier. Any bind which does not have an explicit `U` or `D` is interpreted as if it is followed by an optional keyup event, unless it is the final key. For example, `gg` becomes `g<?U-g>g`. Explicit keydown events, e.g. `<D-z>`, are not allowed to be the automatic repeat firings you get if you hold the key down.
Additionally, you can bind explicitly to a keydown or keyup event with the `D` and `U` modifiers respectively. You can make any bind optional by giving it a `?` modifier. Any bind which does not have an explicit `U` or `D` is interpreted as if it is followed by an optional keyup event, unless it is the final key. For example, `gg` becomes `g<?U-g>g`. Explicit keydown events, e.g. `<D-z>`, are not allowed to be the automatic repeat firings you get if you hold the key down. `hint` and `gobble` mode do not currently support `keyup` events.
An imaginative use of this is a "layer" where holding a key down changes the rest of the bindings: