summaryrefslogtreecommitdiff
path: root/README.md
diff options
context:
space:
mode:
authorRan Benita <ran234@gmail.com>2017-07-25 21:57:42 +0300
committerRan Benita <ran234@gmail.com>2017-07-31 20:53:39 +0300
commit86434d8498fdc674a8b1c9fe7f9f4b4ca54240a5 (patch)
tree0485f8ffba44155afa6b0f2b8de122561ea3b79a /README.md
parent75ec764ceec9aacddfd34f6066f2d5e7cafc8c51 (diff)
downloadxorg-lib-libxkbcommon-86434d8498fdc674a8b1c9fe7f9f4b4ca54240a5.tar.gz
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>
Diffstat (limited to 'README.md')
-rw-r--r--README.md15
1 files changed, 8 insertions, 7 deletions
diff --git a/README.md b/README.md
index 04a5df0..9aab641 100644
--- a/README.md
+++ b/README.md
@@ -11,18 +11,19 @@ See [Quick Guide](doc/quick-guide.md).
## Building
-libxkbcommon is built the typical autoconf way:
+libxkbcommon is built with [Meson](http://mesonbuild.com/):
- ./autogen.sh
- make
+ 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:
- ./autogen.sh --disable-x11 \
- --with-xkb-config-root=/usr/share/X11/xkb \
- --with-x-locale-root=/usr/share/X11/locale
- make
+ meson build \
+ -Denable-x11=false \
+ -Dxkb-config-root=/usr/share/X11/xkb \
+ -Dx-locale-root=/usr/share/X11/locale
+ ninja -C build
## API