+See [Introduction to XKB][XKB] to learn the essentials of XKB.
+
+See [Quick Guide](doc/quick-guide.md) for an introduction on how to use this
+library.
+
+## Building
+
+libxkbcommon is built with [Meson](http://mesonbuild.com/):
+
+ meson setup build
+ meson compile -C build
+ meson test -C build # Run the tests.
+
+To build for use with Wayland, you can disable X11 support while still
+using the X11 keyboard configuration resource files thusly:
+
+ meson setup build \
+ -Denable-x11=false \
+ -Dxkb-config-root=/usr/share/X11/xkb \
+ -Dx-locale-root=/usr/share/X11/locale
+ meson compile -C build