kc3-lang/libxkbcommon/test/data/compat/level3-v2

Branch : - branch - android master - tag -

• 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

• test/data/compat/level3-v2

• partial xkb_compatibility "latchOnPress" {
  
      virtual_modifiers  LevelThree;
  
      interpret.repeat= False;
      setMods.clearLocks= True;
      latchMods.clearLocks= True;
      latchMods.latchToLock= True;
  
      interpret ISO_Level3_Latch+Any {
  	useModMapMods= level1;
  	virtualModifier= LevelThree;
  	action= LatchMods(modifiers=LevelThree, latchOnPress);
      };
  
      interpret ISO_Level3_Latch {
  	action= LatchMods(modifiers=LevelThree, latchOnPress);
      };
  };
  
  partial xkb_compatibility "latchOnRelease" {
  
      virtual_modifiers  LevelThree;
  
      interpret.repeat= False;
      setMods.clearLocks= True;
      latchMods.clearLocks= True;
      latchMods.latchToLock= True;
  
      interpret ISO_Level3_Latch+Any {
  	useModMapMods= level1;
  	virtualModifier= LevelThree;
  	action= LatchMods(modifiers=LevelThree, latchOnPress=false);
      };
  
      interpret ISO_Level3_Latch {
  	action= LatchMods(modifiers=LevelThree, latchOnPress=false);
      };
  };