kc3-lang/libxkbcommon/tools/xkbcli-compile-keymap.1

• Show log

  Commit

• Hash : 275ffa66
  Author :
  Date : 2025-03-13T21:28:35
  

  tools: Make --kccgst xkbcli-compile-keymap option public
  
  The new public option `--kccgst` enables to display the result of RMLVO
  resolution to KcCGST components.
  
  This option has the same function than `setxkbmap -print`. This is particularly
  useful for debugging issues with the rules.
  
  Before this commit it was a private API. This commit enables us to remove
  the *internal* version of `xkbcli-compile-keymap`.
  

Download

• tools/xkbcli-compile-keymap.1

• .Dd June 4, 2024
  .Dt XKBCLI\-COMPILE\-KEYMAP 1
  .Os
  .
  .Sh NAME
  .Nm "xkbcli\-compile\-keymap"
  .Nd compile an X Keyboard keymap
  .
  .Sh SYNOPSIS
  .Nm
  .Op Ar options
  .Op Ar KEYMAP_PATH
  .
  .Sh DESCRIPTION
  .Nm
  compiles and prints a keymap based on the given options.
  .
  .Bl -tag -width Ds
  .It Ar KEYMAP_PATH
  Path to a keymap file, or
  .Dq \-
  to read the standard input
  .
  .It Fl \-help
  Print help and exit
  .
  .It Fl \-verbose
  Enable verbose debugging output
  .
  .It Fl \-test
  Test compilation but do not print the keymap
  .
  .It Fl \-rmlvo
  Print the full RMLVO with the defaults filled in for missing elements
  .
  .It Fl \-kccgst
  Print a keymap which only includes the KcCGST component names instead
  of the full keymap
  .
  .It Fl \-keymap Oo Ar PATH Oc , Fl \-from\-xkb Oo Ar PATH Oc
  Load the XKB file from a file, ignore RMLVO options. If
  .Ar PATH
  is empty or
  .Dq \- ,
  read the stdin.
  .
  .It Fl \-include Ar PATH
  Add the given path to the include path list.
  This option is order\-dependent, include paths given first are searched first.
  If an include path is given, the default include path list is not used.
  Use
  .Fl \-include\-defaults
  to add the default include paths.
  .
  .It Fl \-include\-defaults
  Add the default set of include directories.
  This option is order-dependent, include paths given first are searched first.
  .
  .It Fl \-rules Ar rules
  The XKB ruleset
  .
  .It Fl \-model Ar model
  The XKB model
  .
  .It Fl \-layout Ar layout
  The XKB layout
  .
  .It Fl \-variant Ar variant
  The XKB layout variant
  .
  .It Fl \-options Ar options
  The XKB options
  .
  .It Fl \-enable\-environment\-names
  Allow to set the default RMLVO values via the following environment variables:
  .Bl -dash -compact -hang
  .It
  .Ev XKB_DEFAULT_RULES
  .It
  .Ev XKB_DEFAULT_MODEL
  .It
  .Ev XKB_DEFAULT_LAYOUT
  .It
  .Ev XKB_DEFAULT_VARIANT
  .It
  .Ev XKB_DEFAULT_OPTIONS
  .El
  Note that this option may affect the default values of the previous options.
  .
  .El
  .
  .Sh SEE ALSO
  .Xr xkbcli 1 ,
  .Lk https://xkbcommon.org "The libxkbcommon online documentation"
  

Download