.TH XKBSEL-AW 1 "22 Jul 1999" "xkbsel" ""
.\" $Id: xkbsel-aw.1,v 1.3 1999/07/24 15:13:16 stano Exp $
.SH NAME
xkbsel-aw \- select keyboard layout using a Xaw GUI

.SH SYNOPSIS

.B xkbsel-aw
[\fIOPTION\fR]
.SH DESCRIPTION
.B xkbsel-aw
is a simple GUI for selecting the keyboards and
indicating the current selection. It displays
a window where the current selection is indicated.
When clicking on this window, a menu of the
configured map shortcuts together with the
descriptions pops up, allowing to select
one of them.
.Bxkbsel-aw
installs the first configured map when started.
.SH OPTIONS
.B xkbsel-aw
has no own options, but it accepts common Xt options
such as \fI-display\fR, \fI-geometry\fR, \fI-bg\fB
or \fI-fg\fR. As the map descriptions are normally
written in local language,
.B xkbsel-aw
is using font sets instead of fonts to allow
automatic encoding selection based on current
locale. That means that \fI-fn\fR will \fInot\fR
work. Use fontSet for this purpose, either on the
command line
using e.g.
.br
-xrm '*fontSet: -*-courier-medium-r-*-*-*-100-*-*-m-*-*-*'
.br
or use application default file.
.SH EXAMPLES
.SS Fvwm2 configuration
Following lines added to \fI.fvwm2rc\fR will automatically
start the selector on login:
.br

.RS
Style "\fBxkbsel-aw\fR" NoTitle, Sticky, WindowListSkip
.br

.br
AddToFunc "InitFunction" "I" ...
.br
[...original stuff...]
.br
+ "I" Exec exec \fBxkbsel-aw\fR -geometry 48x24-0-0 &

.RE
If you are using \fIFvwmWharf\fR or \fIFvwmButtons\fR modules,
instead of starting and explicitly positioning \fBxkbsel-aw\fR
in \fIInitFunction\fR you can dock the application into them using
the \fISwallow\fR directory, e.g. by adding following
line into your \fIFvwmButtons\fR configuration
in \fI.fvwm2rc\fR (should be written on single line):
.RS
.br

*FvwmButtons(Swallow (NoHints) "\fBxkbsel-aw\fR"
.br
  'Exec \fBxkbsel-aw\fR -geometry 48x24')
.br

.RE
To switch the keyboards on ctrl-F1, -F2 etc., add
something like this into your \fI.fvwm2rc\fR:
.RS
.br

Key F1 A C Exec exec \fBxkbsel\fR us
.br
Key F2 A C Exec exec \fBxkbsel\fR sk
.br
Key F3 A C Exec exec \fBxkbsel\fR cs
.RE
.SH FILES
.TP
.BI /etc/xkbsel.conf
system configuration file
.TP
.BI ~/.xkbsel/xkbsel.conf
user\'s configuration file
.SH SEE ALSO
.BR xkbseldb (1),
.BR xkbsel (1),
.BR xkbsel (5)
.SH AUTHOR
Stanislav Meduna <stano@trillian.eunet.sk>