NAME

xkbind - X Keyboard Extention 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 Extention 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

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