
		Kbd-query by Tero Kivinen <kivinen@iki.fi>
		www-site: http://www.acr.fi/kbd-query/

Description
-----------

Kbd-query is a program that allows you to easily change the keyboard
layout using setxkbmap program. It also supports additional xmodmap
changes to be done after the keyboard layout is changed (i.e it allows
you to map the capslock to control no matter which keyboard layout you
select).

Compilation
-----------

Unpack the distribution by saying

	tar zxvf kbd-query-x.x.tar.gz

or

	gzip -cd | tar xvf -

After the distribution has been unpacked cd to the directory created
and run the configure script:

	cd kbd-query-x.x
	./configure

After that just say make install to install the package.

How to use kbd-query
--------------------

Just start the kbd-query without any options to complete list of
supported keyboard layouts (for XFree86 4.0.1). If you want just few
of the layouts, start the kbd-query like:

	kbd-query --layouts us,fi

or

	kbd-query --layouts us,fi --initial us --geometry -0+0

to start kbd-query having finnish and us layouts with initial layout
as us, to the top right corner. 

If you have .xmodmap and .xmodmap-fi files, then if you add option:

	kbd-query --layouts us,fi --xmodmap .xmodmap

then when you switch to Finnish keyboard layout the .xmodmap-fi is run
through the xmodmap after the keyboard layout is changed. When you
switch o us keyboard layout then it notices that you do not have
.xmodmap-us file, so it simply uses the .xmodmap file instead.

This way the .xmodmap file can just map Control to Capslock and the
.xmodmap-fi can do the same but also remove to annoying dead keys or
similar.

You can also add all options to .kbdqueryrc file:

	initial=us
	layouts=us,fi
	xmodmap=/home/user/.xmodmap


If you add command

	kbd-query --geometry +0-0 --layouts us,fi --initial us &

to xdm/Xsetup_0 and

	KBD_LAYOUT=`kbd-query --remote query`
	export KBD_LAYOUT
	kbd-query --remote quit

to your xdm/Xsession then it will start kbd-query for the xdm session
and exit immediately when user logs in so user can start their own
kbd-query with their own configuration parameters (i.e the --xmodmap
option). 

Reporting bugs
--------------

If you find a bug or have a feature request send them to
kbd-query-bugs@acr.fi.

					Tero Kivinen
					kivinen@iki.fi
					http://www.iki.fi/kivinen/
