Edit

kc3-lang/libxkbcommon/changes/api/+latchOnPress.feature.md

Branch :

  • Show log

    Commit

  • Author : Pierre Le Marre
    Date : 2025-06-17 16:43:05
    Hash : 69c3d257
    Message : keymap: Add parameter `latchOnPress` for LatchMods() Some keyboard layouts use `ISO_Level3_Latch` or `ISO_Level5_Latch` to define “built-in” dead keys: - they do not rely on the installation of custom Compose file; - they do not clash with other layouts. However, layout projects usually want the exact same behavior on all OS, but the XKB latch behavior (often misunderstood) also acts as a *set* modifier, which is not expected. The usual behavior of a dead key on Linux, macOS and Windows is: - latch on press; - deactivate as soon as another (non-modifier) key is pressed. Added the parameter `latchOnPress` to `LatchMods()` to enable the aforementioned behavior. As it is incompatible with X11, this feature is available only using the keymap text format v2. [XKB protocol key actions]: https://www.x.org/releases/current/doc/kbproto/xkbproto.html#Key_Actions

  • changes/api/+latchOnPress.feature.md 
  • Added the new parameter `latchOnPress` for the key action `LatchMods()`.

Some keyboard layouts use `ISO_Level3_Latch` or `ISO_Level5_Latch` to define
“built-in” dead keys. `latchOnPress` enables to behave as usual dead keys, i.e.
to latch on press and to deactivate as soon as another (non-modifier) key is
pressed.

As it is incompatible with X11, this feature is available only using the keymap
text format v2.

[XKB protocol key actions]: https://www.x.org/releases/current/doc/kbproto/xkbproto.html#Key_Actions