kc3-lang/libxkbcommon/changes/api/+component-includes.feature.md

• Show log

  Commit

• Hash : 39b4b670
  Author :
  Date : 2025-06-06T18:40:29
  

  Support including keymap components using %-expansion and absolute path
  
  Enable to use the same `include` features than *rules* files in
  *keymap components*:
  - *`%`-expansion*: `%H` home directory, `%S` sytem root and `%E` extra.
  - absolute file paths.
  
  This is useful if one wants to overwrite the system file with a user
  config (i.e. same name, but in `~/.config/xkb`), but still include the
  system file:
  
  ```
  // File: ~/.config/xkb/symbols/de
  xkb_symbols "basic" {
      include "%S/de(basic)"
      key <AB01> { [z, Z] };
      key <AD06> { [y, Y] };
  }
  ````
  
  Without the commit, using a mere `include "de(basic)"` would result in
  an include loop.
  
  Refactored by using the same code for rules and keymap components.
  

Download

---

Source

• changes/api/+component-includes.feature.md

• Enable to use absolute paths and `%`-expansion variables for including
  *keymap components*, in the same fashion than the *rules* files.
  

Download