.TH XKBSELDB 1 "22 Jul 1999" "xkbsel" ""
.\" $Id: xkbseldb.1,v 1.2 1999/07/23 14:46:32 stano Exp $
.SH NAME
xkbseldb \- maintain xkbsel databases

.SH SYNOPSIS

.B xkbseldb
[\-rRmMlLc] [\-b] [\-x] [\-v] [\-\-debug]
.br
.B xkbseldb
{\-\-help,\-\-version}
.SH DESCRIPTION
The
.B xkbsel
package stores its keymap definitions in the system
and user directory hierarchies and provides an access
to them based on system and user configuration files.
As this is a lot of scattered data and the mapping selection
process should be fast, the definitions are hashed
and the mappings mentioned in the configuration
files are precompiled into a quick readable
internal form.
.PP
.B xkbseldb
is used to maintain this internal data. The available
options are:
.TP
\fB\-R\fR, \fB\-\-rebuild\-system\fR
rebuild the system database
.TP
\fB\-r\fR, \fB\-\-rebuild\-user\fR
rebuild the user\'s database
.TP
\fB\-M\fR, \fB\-\-missing\-system\fR
output a template covering missing
.B xkbsel
metadata for X11 and system mappings
.TP
\fB\-m\fR, \fB\-\-missing\-user\fR
output a template covering missing user metadata
.TP
\fB\-L\fR, \fB\-\-list\-system\fR
list the content of the system database
.TP
\fB\-l\fR, \fB\-\-list\-user\fR
list the content of the databases from the user\'s
point of view
.TP
\fB\-b\fR, \fB\-\-brief\fR
when listing content, output map names only
.TP
\fB\-x\fR, \fB\-\-explicit\fR
when listing content, leave out maps that are taken
from the X11 distribution without modification
.TP
\fB\-c\fR, \fB\-\-check\fR
output the current configuration
.TP
\fB\-v\fR, \fB\-\-verbose\fR
be verbose
.TP
\fB\-\-debug\fR
be very verbose
.TP
\fB\-\-help\fR
output brief usage instructions
.TP
\fB\-\-version\fR
output the version of the program
.PP
You must rebuild the system database every time you
add or delete a keyboard mapping included in the
X11 or package\'s system directories, when you
change a metadata describing the mapping (see
.BR xkbsel (5)
for the formats) or when you change the
content of the XKB definitions such that
the resulting mapping is different.
It is strongly advised to rebuild the database
when you add new shortcut definitions into the
system configuration file so that the system
precompiles them (otherwise they will be compiled
at each user who selects them).
.PP
The situation for the user databases is similar -
if the user\'s
.B xkbsel
directory is nonempty, a rebuild is needed after
each change of these data. To put it shortly:
if in doubt, do the rebuilds.
.PP
The \fB\-\-missing\-system\fR and \fB\-\-missing\-user\fR
options are for the people willing to define the
maps themselves. The output should be filled in
and installed as a redefinition file. Don\'t
mess with this if you only want to use the package.
.PP
Using \fB\-\-check\fR and \fB\-\-list\-user\fR
\fB\-\-brief\fR can often help in debugging
configuration issues.
.SH FILES
.TP
.BI /usr/X11R6/lib/X11/xkb
XKB hierarchy of the X11 distribution
.TP
.BI /usr/share/xkbsel
system data directory
.TP
.BI /etc/xkbsel.conf
system configuration file
.TP
.BI /var/xkbsel
system directory for the hash database and
precompiled keymaps
.TP
.BI ~/.xkbsel
user data directory
.TP
.BI ~/.xkbsel/xkbsel.conf
user\'s configuration file
.SH SEE ALSO
.BR xkbsel (1),
.BR xkbsel-aw (1),
.BR xkbsel (5)
.SH BUGS
Should automagically determine when the user database needs
a rebuild.
.SH AUTHOR
Stanislav Meduna <stano@trillian.eunet.sk>