NAME

       xkbind - X Keyboard Extension Indicator for the X Window System

SYNOPSIS

       xkbind -help
       xkbind -version
       xkbind  [-display  displayname]  [-force]  [-nodetach]  [-defgrp  group]  [-deflbl  label]
       [-label0 label] [-label1 label] [-label2  label]  [-label3  label]  [-iname  <name  list>]
       [-iclass <class list>] [-ireverse] [-inowild]

DESCRIPTION

       The  xkbind  program  (X  Keyboard  Extension Indicator) is a small and light indicator of
       keyboard layout (XKB group) for  the X Window System; it shows current keyboard layout  in
       titles  of top-level windows.  xkbind allows to simulate separate keyboard layout for each
       handled window and it works with most of window managers.

       xkbind exits 0 on success, and greater than 0 if an error occurs.

OPTIONS

       xkbind accepts a number options most of which can be specified either on the command line,
       in  the user's $HOME/.xkbindrc, $HOME/.Xdefaults (or $HOME/.Xresources), or in the system-
       wide configuration file.  Description of all the acceptable options is given  below.   The
       command  line  option  is  specified  first with correspondent X resource name (if any) in
       parenthesis afteward.  Options specified on the command line have  the  highest  priority.
       The -version and -help options interpreted even if xkbind can not open the display.

       -help  Print a short help message to stderr and exit.

       -version
              Print a version number of xkbind to stderr and exit.

       -force Do  not  allow xkbind automatically check existence of its own copy already running
              on the specified X server.

       -nodetach
              Do not detach as a background process.

       -display displayname (display)
              The X server to use.  This option overrides the  contents  of  DISPLAY  environment
              variable.

       -defgrp group (defgroup)
              Group number that xkbind initially binds to each handled window.

       -deflbl label (label.default)
              The default value for options label.group[0-3].

       -label[0-3] label (label.group[0-3])
              A label string for the specified keyboard group.

       -iname <name list> (ignore.name)
              Space-  or  tab-separated  list  of window names (WM_CLASS(res_name) property) that
              should be ignored by xkbind.

       -iclass <class list> (ignore.class)
              Space- or tab-separated list of window classes (WM_CLASS(res_class) property)  that
              should be ignored by xkbind.

       -reverse (ignore.reverse)
              Indicates  that the "ignore list" in options ignore.name and ignore.class should be
              interpreted as "accept list"

       -nowild (ignore.usewild)
              Disable pattern matching while searching in window lists.

RESOURCES

       The format of the option in the X resources files is  "Xkbind.option:  value",  where  the
       option name is the one specified below.

       display
              The X server to use.  The default is the contents of environment variable DISPLAY.

       defgroup
              Group  number  that  xkbind initially binds to each handled window.  The default is
              the current group when the program starts.

       label.default
              The default value for options label.group[0-3].  It defaults itself  to  the  empty
              string.

       label.group[0-3]
              A  label  string  for  the  specified  keyboard group.  The default is the value of
              label.default option.

       ignore.name
              Space- or tab-separated list of window  names  (WM_CLASS(res_name)  property)  that
              should be ignored by xkbind.

       ignore.class
              Space-  or tab-separated list of window classes (WM_CLASS(res_class) property) that
              should be ignored by xkbind.

       ignore.reverse
              Specifies whether or not an "ignore list" in options ignore.name  and  ignore.class
              should be interpreted as an "accept list".  The default is "False".

       ignore.usewild
              Specifies  whether  or  not  symbols  '*',  '?' and '\' in the name and class lists
              should be interpreted in the special way (like in the shell pattern matching).  The
              default is "True".

SIGNALS

       SIGALRM

       SIGVTALRM

       SIGHUP

       SIGPROF
              xkbind ignores these signals.

       SIGINT

       SIGTERM

       SIGABRT
              xkbind performs cleanup and normal exit.

ENVIRONMENT

       DISPLAY
              Default host and display number.

FILES

       xkbind reads configuration options from the following files in the order of priority:

       $HOME/.xkbindrc
              User's private configuration file.

       $HOME/.Xresources or $HOME/.Xdefaults
              User's X defaults file.

       /etc/local/lib/xkbind/app-defaults/Xkbind
              System-wide X defaults file.  The actual pathname may differ on your system.

BUGS

       Compount text encoding of international characters in label strings is not implemented.

AUTHORS

       Copyright (C) 2004 CHG

       This program is free software; you can redistribute it and/or modify it under the terms of
       the GNU General Public License as  published  by  the  Free  Software  Foundation;  either
       version 2 of the License, or (at your option) any later version.

       This  program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY;
       without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR  PURPOSE.
       See the GNU General Public License for more details.

       You should have received a copy of the GNU General Public License along with this program;
       if not, write to the Free Software Foundation, Inc., 59 Temple Place, Suite  330,  Boston,
       MA  02111-1307  USA