summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorBryce Harrington <bryce@osg.samsung.com>2016-09-15 14:31:55 -0700
committerRan Benita <ran234@gmail.com>2016-09-16 09:24:09 +0300
commitaf2c83b6642591cf36d4002decef6757ec90b3e2 (patch)
treec35798b25f77101f9f8c47e0893073d2147e0f48
parente92e0b88c6e3f7e6005d208e95f5dff760d7a3c4 (diff)
downloadxorg-lib-libxkbcommon-af2c83b6642591cf36d4002decef6757ec90b3e2.tar.gz
README: Add basic build directions
In particular, highlight the use of configure flags to control locating X11 keyboard stuff when building for Wayland. Of particular note, if the locale root is not specified, then xkbcommon will look for them under $prefix (i.e. /usr/local/share/X11/locale). But unless the user has specifically installed them there, it is better to look in the standard system location, /usr/share/X11/locale. Otherwise, xkbcommon will error when it can't find them, e.g.: xkbcommon: ERROR: ~/.XCompose:4:9: failed to expand %L to the locale Compose file xkbcommon: ERROR: ~/.XCompose:4:12: unterminated string literal Signed-off-by: Bryce Harrington <bryce@osg.samsung.com> Signed-off-by: Ran Benita <ran234@gmail.com>
-rw-r--r--README.md15
1 files changed, 15 insertions, 0 deletions
diff --git a/README.md b/README.md
index 706822a..04a5df0 100644
--- a/README.md
+++ b/README.md
@@ -9,6 +9,21 @@ and dead keys.
See [Quick Guide](doc/quick-guide.md).
+## Building
+
+libxkbcommon is built the typical autoconf way:
+
+ ./autogen.sh
+ make
+
+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
+
## API
While libxkbcommon's API is somewhat derived from the classic XKB API as found