kc3-lang/libxkbcommon/changes/api/+rmlvo-builder-api.feature.md

• Show log

  Commit

• Hash : da5caabb
  Author :
  Date : 2025-06-16T15:45:42
  

  Add RMLVO builder API
  
  Before this commit, the API to work with RMLVO was quite minimal: it
  only uses raw strings from the `xkb_rule_names` struct. However:
  
  - it forces the users to deal with error-prone string formatting;
  - it does not enforce tying together layouts and variants;
  - it limits adding new features by requiring defining delimiter
    characters and the corresponding parsing.
  
  Added the following API:
  
  - `xkb_rmlvo_builder_new()`
  - `xkb_rmlvo_builder_append_layout()`
  - `xkb_rmlvo_builder_append_option()`
  - `xkb_rmlvo_builder_unref()`
  
  There is no intermediate `layout` nor `option` object, in order to
  to keep the API simple. The only foreseen extension is enabling
  configuring layout-specific options.
  

Download

---

Source

• changes/api/+rmlvo-builder-api.feature.md

• Added a API to safely build a RMLVO configuration:
  - `xkb_rmlvo_builder_new()`
  - `xkb_rmlvo_builder_append_layout()`
  - `xkb_rmlvo_builder_append_option()`
  - `xkb_rmlvo_builder_unref()`
  

Download