xkbcomp(1) - NetBSD Manual Pages

Command:
Section:
Arch:
Collection:
>>>



XKBCOMP(1)					       XKBCOMP(1)



NAME

       xkbcomp - compile XKB keyboard description


SYNOPSIS

       xkbcomp [option] source [ destination ]


DESCRIPTION

       The  xkbcomp  keymap compiler converts a description of an
       XKB keymap into one of several output formats.	The  most
       common use for xkbcomp is to create a compiled keymap file
       (.xkm extension) which can be read directly by XKB-capable
       X  servers  or  utilities.    The keymap compiler can also
       produce C header files or XKB source files.  The C  header
       files  produced by xkbcomp can be included by X servers or
       utilities that need a built-in default  keymap.	 The  XKB
       source  files  produced	by xkbcomp are fully resolved and
       can be used to verify that the files which typically  make
       up  an XKB keymap are merged correctly or to create a sin-
       gle file which contains	a  complete  description  of  the
       keymap.

       The source may specify an X display, or an .xkb or depends
       on the format of the source.   Compiling	 a  .xkb  (keymap
       source)	file  generates	 a .xkm (compiled keymap file) by
       default.	  If the source is a .xkm file or an  X	 display,
       xkbcomp generates a keymap source file by default.

       If  the	destination  is	 an X display, the keymap for the
       display is updated with the compiled keymap.

       The name of the destination is usually computed	from  the
       name  of the source, with the extension replaced as appro-
       priate.	When compiling a single map  from  a  file  which
       contains	 several  maps, xkbcom constructs the destination
       file name by appending an  appropriate  extension  to  the
       name of the map to be used.


OPTIONS

       -a      Show  all keyboard information, reporting implicit
	       or dervied information as a comment.  Only affects
	       .xkb format output.

       -C      Produce	a C header file as output (.h extension).

       -dflts  Compute defaults for any missing components,  such
	       as key names.

       -Idir   Specifies top-level directories to be searched for
	       files included by the keymap description.

       -l      List maps that specify  the  map	 pattern  in  any
	       files  listed on the command line (not implemented
	       yet).




X Version 11		   Release 6.3				1





XKBCOMP(1)					       XKBCOMP(1)


       -m name Specifies a map to be compiled from an  file  with
	       multiple entries.

       -merge  Merge  the  compiled information with the map from
	       the server (not implemented yet).

       -o name Specifies a name for the	 generated  output  file.
	       The default is the name of the source file with an
	       appropriate extension for the output format.

       -opt parts
	       Specifies a list of optional  parts.   Compilation
	       errors in any optional parts are not fatal.  Parts
	       may consist of any combination of the  letters  c,
	       g,k,s,t which specify the compatibility map, geom-
	       etry, keycodes, symbols and types, respectively.

       -Rdir   Specifies the root  directory  for  relative  path
	       names.

       -synch  Force synchonization for X requests.

       -w lvl  Controls the reporting of warnings during compila-
	       tion.  A warning level of 0 disables all warnings;
	       a warning level of 10 enables them all.

       -xkb    Generate	 a  source description of the keyboard as
	       output (.xkb extension).

       -xkm    Generate a compiled keymap file	as  output  (.xkm
	       extension).


SEE ALSO

       X(1)


COPYRIGHT

       Copyright  1994,	 Silicon  Graphics Computer Systems and X
       Consortium, Inc.
       See X(1) for a full statement of rights and permissions.


AUTHOR

       Erik Fortune, Silicon Graphics















X Version 11		   Release 6.3				2