192 lines
5.7 KiB
HTML
192 lines
5.7 KiB
HTML
|
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
|
<HTML><HEAD><TITLE>Man page of XKBCOMP</TITLE>
|
|
</HEAD><BODY>
|
|
<H1>XKBCOMP</H1>
|
|
Section: User Commands (1)<BR>Updated: xkbcomp 1.4.3<BR><A HREF="#index">Index</A>
|
|
<A HREF="/cgi-bin/man/man2html">Return to Main Contents</A><HR>
|
|
|
|
<A NAME="lbAB"> </A>
|
|
<H2>NAME</H2>
|
|
|
|
xkbcomp - compile XKB keyboard description
|
|
<A NAME="lbAC"> </A>
|
|
<H2>SYNOPSIS</H2>
|
|
|
|
<B>xkbcomp</B>
|
|
|
|
[option] source [ destination ]
|
|
<A NAME="lbAD"> </A>
|
|
<H2>DESCRIPTION</H2>
|
|
|
|
<P>
|
|
|
|
The
|
|
<I>xkbcomp</I>
|
|
|
|
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 <I>xkbcomp</I> 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 single file which contains a complete
|
|
description of the keymap.
|
|
<P>
|
|
|
|
The <I>source</I> may specify an X display, or an <I>.xkb</I> or <I>.xkm</I>
|
|
file; unless explicitly specified, the format of <I>destination</I>
|
|
depends on the format of the source. Compiling a <I>.xkb</I> (keymap source)
|
|
file generates a <I>.xkm</I> (compiled keymap file) by default. If the
|
|
source is a <I>.xkm</I> file or an X display, <I>xkbcomp</I> generates a
|
|
keymap source file by default.
|
|
<P>
|
|
|
|
If the <I>destination</I> is an X display, the keymap for the display
|
|
is updated with the compiled keymap.
|
|
<P>
|
|
|
|
The name of the <I>destination</I> is usually computed from the name
|
|
of the source, with the extension replaced as appropriate. When compiling
|
|
a single map from a file which contains several maps, <I>xkbcomp</I> constructs
|
|
the destination file name by appending an appropriate extension to the
|
|
name of the map to be used.
|
|
<A NAME="lbAE"> </A>
|
|
<H2>OPTIONS</H2>
|
|
|
|
<DL COMPACT>
|
|
<DT id="1"><B>-a</B>
|
|
|
|
<DD>
|
|
Show all keyboard information, reporting implicit or derived information
|
|
as a comment. Only affects <I>.xkb</I> format output.
|
|
<DT id="2"><B>-C</B>
|
|
|
|
<DD>
|
|
Produce a C header file as output (.h extension).
|
|
<DT id="3"><B>-dflts</B>
|
|
|
|
<DD>
|
|
Compute defaults for any missing components, such as key names.
|
|
<DT id="4"><B>-em1 </B><I>msg</I>
|
|
|
|
<DD>
|
|
Print <I>msg</I> before printing first error message.
|
|
<DT id="5"><B>-emp </B><I>msg</I>
|
|
|
|
<DD>
|
|
Print <I>msg</I> at the start of each message line.
|
|
<DT id="6"><B>-eml </B><I>msg</I>
|
|
|
|
<DD>
|
|
If there were any errors, print <I>msg</I> before exiting.
|
|
<DT id="7"><B>-help, -?</B>
|
|
|
|
<DD>
|
|
Show available options.
|
|
<DT id="8"><B>-I</B><I>dir</I>
|
|
|
|
<DD>
|
|
Specifies top-level directories to be searched for files included by the
|
|
keymap description. After all directories specified by -I options
|
|
have been searched, the current directory and finally, the default
|
|
xkb directory /usr/share/X11/xkb will be searched.
|
|
<P>
|
|
To prevent the current and default directories from being searched,
|
|
use the -I option alone (i.e. without a directory), before any -I
|
|
options that specify the directories you do want searched.
|
|
<DT id="9"><B>-i </B><I>deviceid</I>
|
|
|
|
<DD>
|
|
If <I>source</I> or <I>destination</I> is a valid X display, load the keymap
|
|
from/into the device with the specified ID (not name).
|
|
<DT id="10"><B>-l</B>
|
|
|
|
<DD>
|
|
List maps that specify the <I>map</I> pattern in any files listed on the
|
|
command line (not implemented yet).
|
|
<DT id="11"><B>-m </B><I>name</I>
|
|
|
|
<DD>
|
|
Specifies a map to be compiled from an file with multiple entries.
|
|
<DT id="12"><B>-merge</B>
|
|
|
|
<DD>
|
|
Merge the compiled information with the map from the server (not implemented
|
|
yet).
|
|
<DT id="13"><B>-o </B><I>name</I>
|
|
|
|
<DD>
|
|
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.
|
|
<DT id="14"><B>-opt </B><I>parts</I>
|
|
|
|
<DD>
|
|
Specifies a list of optional parts. Compilation errors in any optional parts
|
|
are not fatal. Parts may consist of any combination of the letters <I>c</I>,
|
|
<I>g</I>,<I>k</I>,<I>s</I>,<I>t</I> which specify the compatibility map, geometry,
|
|
keycodes, symbols and types, respectively.
|
|
<DT id="15"><B>-R</B><I>dir</I>
|
|
|
|
<DD>
|
|
Specifies the root directory for relative path names.
|
|
<DT id="16"><B>-synch</B>
|
|
|
|
<DD>
|
|
Force synchronization for X requests.
|
|
<DT id="17"><B>-version</B>
|
|
|
|
<DD>
|
|
Print version number.
|
|
<DT id="18"><B>-w </B><I>lvl</I>
|
|
|
|
<DD>
|
|
Controls the reporting of warnings during compilation. A warning level
|
|
of 0 disables all warnings; a warning level of 10 enables them all.
|
|
<DT id="19"><B>-xkb</B>
|
|
|
|
<DD>
|
|
Generate a source description of the keyboard as output (.xkb extension).
|
|
<DT id="20"><B>-xkm</B>
|
|
|
|
<DD>
|
|
Generate a compiled keymap file as output (.xkm extension).
|
|
</DL>
|
|
<A NAME="lbAF"> </A>
|
|
<H2>SEE ALSO</H2>
|
|
|
|
<A HREF="/cgi-bin/man/man2html?7+X">X</A>(7)
|
|
<A NAME="lbAG"> </A>
|
|
<H2>COPYRIGHT</H2>
|
|
|
|
Copyright 1994, Silicon Graphics Computer Systems and X Consortium, Inc.
|
|
<BR>
|
|
|
|
See <I><A HREF="/cgi-bin/man/man2html?7+X">X</A>(7)</I> for a full statement of rights and permissions.
|
|
<A NAME="lbAH"> </A>
|
|
<H2>AUTHOR</H2>
|
|
|
|
Erik Fortune, Silicon Graphics
|
|
<P>
|
|
|
|
<HR>
|
|
<A NAME="index"> </A><H2>Index</H2>
|
|
<DL>
|
|
<DT id="21"><A HREF="#lbAB">NAME</A><DD>
|
|
<DT id="22"><A HREF="#lbAC">SYNOPSIS</A><DD>
|
|
<DT id="23"><A HREF="#lbAD">DESCRIPTION</A><DD>
|
|
<DT id="24"><A HREF="#lbAE">OPTIONS</A><DD>
|
|
<DT id="25"><A HREF="#lbAF">SEE ALSO</A><DD>
|
|
<DT id="26"><A HREF="#lbAG">COPYRIGHT</A><DD>
|
|
<DT id="27"><A HREF="#lbAH">AUTHOR</A><DD>
|
|
</DL>
|
|
<HR>
|
|
This document was created by
|
|
<A HREF="/cgi-bin/man/man2html">man2html</A>,
|
|
using the manual pages.<BR>
|
|
Time: 00:05:31 GMT, March 31, 2021
|
|
</BODY>
|
|
</HTML>
|