kc3-lang/libxkbcommon/README.md

• Show log

  Commit

• Hash : 86434d84
  Author :
  Date : 2017-07-25T21:57:42
  

  build: add meson build system
  
  Meson is easier to maintain, much faster, encourages better practices,
  and is not built on a pile of shell scripts.
  
  The autotools build system is kept intact for now, in order to ease the
  migration. The intention is to remove it sooner rather than later, if
  all goes well.
  
  Run `meson build && mesonconf build` to see the configuration options
  for the new system. Conversion should be straightforward. Environment
  variables like CFLAGS work the same.
  
  If meson is used, xorg-util-macros is not required.
  
  In terms of functionality the two systems have about the same
  capabilities. Here are some differences I noticed:
  
  - Meson uses `-g` by default, autotools uses `-g -O2`.
  
  - In autotools the default behavior is to install both static and shared
    versions of the libraries. In meson the user must choose exactly one
    (using -Ddefault_library=static/shared).
  
    It is possible to workaround if needed (install twice...), but
    hopefully meson will add the option in the future.
  
  - Autotools has builtin ctags/cscope targets, meson doesn't.
  
    Easy to run the tools directly.
  
  - Meson has builtin benchmarks target. Handy.
  
  - Meson has builtin support for sanitizers/clang-analyzer/lto/pgo/
    coverage etc. Also handy.
  
  Signed-off-by: Ran Benita <ran234@gmail.com>
  

Download

meson build
ninja -C build

meson build \
    -Denable-x11=false \
    -Dxkb-config-root=/usr/share/X11/xkb \
    -Dx-locale-root=/usr/share/X11/locale
ninja -C build

http://www.freedesktop.org/wiki/Software/XKeyboardConfig

http://xkbcommon.org

https://github.com/xkbcommon/libxkbcommon

<xorg-devel@lists.x.org> or <wayland-devel@lists.freedesktop.org>

Bugzilla https://bugs.freedesktop.org/describecomponents.cgi?product=libxkbcommon

Github https://github.com/xkbcommon/libxkbcommon/issues

Source

• 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](doc/quick-guide.md).
  
  ## Building
  
  libxkbcommon is built with [Meson](http://mesonbuild.com/):
  
      meson build
      ninja -C build
  
  To build for use with Wayland, you can disable X11 support while still
  using the X11 keyboard configuration resource files thusly:
  
      meson build \
          -Denable-x11=false \
          -Dxkb-config-root=/usr/share/X11/xkb \
          -Dx-locale-root=/usr/share/X11/locale
      ninja -C build
  
  ## 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](http://xkbcommon.org/doc/current/modules.html).
  
  ## 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](doc/compat.md) 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.
  
  Bug reports are also welcome, and may be filed either at
      Bugzilla https://bugs.freedesktop.org/describecomponents.cgi?product=libxkbcommon
  or
      Github https://github.com/xkbcommon/libxkbcommon/issues
  
  The maintainers are
  - Daniel Stone <daniel@fooishbar.org>
  - Ran Benita <ran234@gmail.com>
  
  ## Credits
  
  Many thanks are due to Dan Nicholson for his heroic work in getting xkbcommon
  off the ground initially.
  

Download