tree: 9a9bd15ccd6a9f218f296b1a274be411ae4246ae [path history] [tgz]
  1. bench/
  2. build-aux/
  3. doc/
  4. m4/
  5. src/
  6. test/
  7. xkbcommon/
  8. .autom4te.cfg
  9. .travis.yml
  10. .uncrustify.cfg
  11. Android.mk
  12. autogen.sh
  13. configure.ac
  14. COPYING
  15. Makefile.am
  16. makekeys.py
  17. NEWS
  18. PACKAGING
  19. README.md
  20. xkbcommon-uninstalled.pc.in
  21. xkbcommon-x11-uninstalled.pc.in
  22. xkbcommon-x11.map
  23. xkbcommon-x11.pc.in
  24. xkbcommon.map
  25. xkbcommon.pc.in
xkbcommon/README.md

libxkbcommon

libxkbcommon is a keyboard keymap compiler and support library which processes a reduced subset of keymaps as defined by the XKB (X Keyboard Extension) specification. It also contains a module for handling Compose and dead keys.

Quick Guide

See Quick Guide.

API

While libxkbcommon's API is somewhat derived from the classic XKB API as found in X11/extensions/XKB.h and friends, it has been substantially reworked to expose fewer internal details to clients.

See the API Documentation.

Dataset

libxkbcommon does not distribute a keymap dataset itself, other than for testing purposes. The most common dataset is xkeyboard-config, which is used by all current distributions for their X11 XKB data. More information on xkeyboard-config is available here: http://www.freedesktop.org/wiki/Software/XKeyboardConfig

The dataset for Compose is distributed in libX11, as part of the X locale data.

Relation to X11

See Compatibility notes.

Development

An extremely rudimentary homepage can be found at http://xkbcommon.org

xkbcommon is maintained in git at https://github.com/xkbcommon/libxkbcommon

Patches are always welcome, and may be sent to either xorg-devel@lists.x.org or wayland-devel@lists.freedesktop.org or through github.

Bugs are also welcome, and may be reported either at Bugzilla https://bugs.freedesktop.org/describecomponents.cgi?product=libxkbcommon or Github https://github.com/xkbcommon/libxkbcommon/issues

The maintainers are

Credits

Many thanks are due to Dan Nicholson for his heroic work in getting xkbcommon off the ground initially.