X-Git-Url: http://review.tizen.org/git/?a=blobdiff_plain;f=PACKAGING;h=95b5a2a17aa3e163a41c1c73cb7a74e94bd314fd;hb=243b0c8703e4339454d7b8e6758ffe6daddbb263;hp=d4f400a0411674872fd0bca9d77ab34ab2d1c68d;hpb=dc275a289fc206d678f643d4b196065d198a2cb6;p=platform%2Fupstream%2Flibxkbcommon.git diff --git a/PACKAGING b/PACKAGING index d4f400a..95b5a2a 100644 --- a/PACKAGING +++ b/PACKAGING @@ -1,26 +1,30 @@ -libxkbcommon consists of two shared libraries, libxkbcommon (the main -library) and libxkbcommon-x11 (an addon library for XCB clients). +libxkbcommon consists of three shared libraries, libxkbcommon (the main +library), libxkbcommon-x11 (an addon library for XCB clients) and libxkbregistry +(a library to list available RMLVO options). The files for libxkbcommon-x11 are: libxkbcommon-x11.a libxkbcommon-x11.so* xkbcommon/xkbcommon-x11.h xkbcommon-x11.map xkbcommon-x11.pc -libxkbcommon-x11 can be disabled with --disable-x11 (see -`./configure --help` for other options/variables). +libxkbcommon-x11 can be disabled with -Denable-x11=false (see +`meson configure build` for other options/variables). -Dependencies for libxkbcommon: -- C compiler, autoconf, automake, pkg-config, libc, etc. +The files for libxkbregistry are: + libxkbregistry.a libxkbregistry.so* xkbcommon/xkbregistry.h + xkbregistry.map xkbregistry.pc + +libxkbregistry can be disabled with -Denable-xkbregistry=false (see +`meson configure build` for other options/variables). -- (build optional) xorg-util-macros. - Output included in tarball. +Dependencies for libxkbcommon: +- C compiler, meson, pkg-config, libc. -- (build optional) bison (preferred) or byacc>=20141006. - Output included in tarball. +- (build) bison (preferred), win_bison or byacc>=20141006. byacc must be configured with --enable-btyacc. -- (build optional, runtime) xkeyboard-config. +- (build optional, runtime required) xkeyboard-config. During build, for automatically detecting the value of - --with-xkb-config-root instead of guessing (/usr/share/X11/xkb). + -Dxkb-config-root instead of guessing (/usr/share/X11/xkb). During runtime, not strictly needed, but most users of the library would need it. @@ -30,10 +34,14 @@ Dependencies for libxkbcommon: - (build optional) doxygen. For generating the HTML documentation. + To disable, use -Denable-docs=false. - (build optional) gperf. Output included in git and tarball. To regenerate, use - `make update-keywords`. + `./scripts/update-keywords`. + +Dependencies for xkbcli: +- libxkbcommon. Dependencies for libxkbcommon-x11: - libxkbcommon. @@ -44,7 +52,25 @@ Dependencies for libxkbcommon-x11 tests: - xkbcomp, Xvfb. If they are not available, the relevant tests are skipped. +Dependencies for libxkbregistry: +- libxkbregistry is a sublibrary of libxkbcommon and cannot be built without + building libxbkcommon. The files produced are otherwise independent. + +- libxml2 + +- (build optional, runtime requirement) xkeyboard-config + During build, for automatically detecting the value of + -Dxkb-config-root instead of guessing (/usr/share/X11/xkb). + +Dependencies for Wayland tests: +- wayland-client>=1.2.0, wayland-scanner, wayland-protocols>=1.0. + To disable, use -Denable-wayland=false. + Unless libxcb is always available as part of the system, it is preferred that libxkbcommon and libxkbcommon-x11 be split into separate packages, such that the main library does not depend on libxcb. This avoids a transitive dependency of Wayland clients on X libraries. + +It is perferred that libxkbregistry be split into a separate packages as most +clients that require libxkbcommon do not require libxkbregistry and clients +requiring libxkbregistry may not need libxkbcommon.