Introduction to libxkbcommon
libxkbcommon is a keymap compiler
and support library which processes a reduced subset of keymaps as
defined by the XKB specification.
This package is known to build and work properly using an LFS 12.3
platform.
Package Information
Note
The tarball libxkbcommon-1.8.0.tar.gz
will extract to the
directory libxkbcommon-xkbcommon-1.8.0.tar.gz
.
libxkbcommon Dependencies
Required
xkeyboard-config-2.44 (runtime)
Recommended
libxcb-1.17.0, Wayland-1.23.0, and
wayland-protocols-1.40
Optional
Doxygen-1.13.2 (for generating the
documentation) and Xvfb (from Xorg-Server-21.1.15 or Xwayland-24.1.5)
Installation of libxkbcommon
Install libxkbcommon by running
the following commands:
mkdir build &&
cd build &&
meson setup .. \
--prefix=/usr \
--buildtype=release \
-D enable-docs=false &&
ninja
To test the results, ensure Xvfb and xkeyboard-config-2.44 are available,
then issue: ninja
test.
Now, as the root
user:
ninja install
Command Explanations
--buildtype=release
:
Specify a buildtype suitable for stable releases of the package, as
the default may produce unoptimized binaries.
-D enable-docs=true
: This
switch enables documentation generation. The Doxygen-1.13.2 is
required.
mv -v
/usr/share/doc/libxkbcommon{,-1.8.0}: If you built
the documentation, use this command to install it in a versioned
directory.
Contents
Installed Programs:
xkbcli
Installed Libraries:
libxkbcommon.so, libxkbcommon-x11.so, and
libxkbregistry.so
Installed Directories:
/usr/include/xkbcommon,
/usr/libexec/xkbcommon, and
/usr/share/doc/libxkbcommon-1.8.0
Short Descriptions
xkbcli
|
provides a debugger and compiler for XKB keymaps
|
libxkbcommon.so
|
contains the libxkbcommon API functions
|
libxkbcommon-x11.so
|
contains the libxkbcommon X11 specific API
functions
|
libxkbregistry.so
|
contains a list of available XKB models, layouts, and
variants for a given ruleset
|