xkbind - X Keyboard Extension Indicator for the X Window
System
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]
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.
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.
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".
- DISPLAY
- Default host and display number.
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.
Compount text encoding of international characters in label
strings is not implemented.
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