77 lines
		
	
	
		
			2.7 KiB
		
	
	
	
		
			Plaintext
		
	
	
	
			
		
		
	
	
			77 lines
		
	
	
		
			2.7 KiB
		
	
	
	
		
			Plaintext
		
	
	
	
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 -Denable-x11=false (see
 | 
						|
`meson configure build` for other options/variables).
 | 
						|
 | 
						|
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).
 | 
						|
 | 
						|
Dependencies for libxkbcommon:
 | 
						|
- C compiler, meson, pkg-config, libc.
 | 
						|
 | 
						|
- (build) bison (preferred), win_bison or byacc>=20141006.
 | 
						|
  byacc must be configured with --enable-btyacc.
 | 
						|
 | 
						|
- (build optional, runtime required) xkeyboard-config.
 | 
						|
  During build, for automatically detecting the value of
 | 
						|
  -Dxkb-config-root instead of guessing (/usr/share/X11/xkb).
 | 
						|
  During runtime, not strictly needed, but most users of the library
 | 
						|
  would need it.
 | 
						|
 | 
						|
- (runtime) libX11.
 | 
						|
  Contains the dataset for Compose support (/usr/share/X11/locale).
 | 
						|
  Please don't depend on it explicitly.
 | 
						|
 | 
						|
- (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
 | 
						|
  `./scripts/update-keywords`.
 | 
						|
 | 
						|
Dependencies for xkbcli:
 | 
						|
- libxkbcommon.
 | 
						|
 | 
						|
Dependencies for libxkbcommon-x11:
 | 
						|
- libxkbcommon.
 | 
						|
 | 
						|
- libxcb>=1.10 with libxcb-xkb.
 | 
						|
 | 
						|
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.
 |