How To Change The MiNT-X11R5 Keyboard Map.
===========================================

Ok, here's a short guide to changing the MiNT-X11R5 keyboard map from
QWERZ to UK standard QWERTY.

Firstly, it's fine that the author compiled for QWERTZ, thats what his
keyboard is so no-one can fault him for it. It's easy to change it...

This archive should contain 4 things (appart from this file).

1) xmodmap.ttp - this is a standard bit of X software which you use
	to configure the keyboard map.
2) xmodmap.man - the Unix manual page for xmodmap.
3) ukXkbd.map - this is a script for xmodmap which will fix the
	keyboard.
4) keysymdef.h - one of the standard X header files.

Doing The Mapping
==================
	
Simply, to do the mapping you issue the command:

	xmodmap ukXkbd.map

at any time after Xwindows has started. Xmodmap changes the keyboard
layout then exits, so you don't waste any memory.

It's useful to do this automaticly, so I have my system set up as
follows:

	ukXkbd.map is in /etc
	startx is in /etc
	.xinitrc is in my home directory.

startx is a short shell script which does any configuration stuff
X requires on my system:

	#startx shell script
	. /etc/profile.local
	date
	banner MiNT-X
	echo Xwindow System For MiNT
	echo
	echo Modifying keymaps to UK standard...
	xmodmap /etc/ukXkbd.map
	echo Allowing all hosts access...
	xhost +

Then, all users on my system have as the first line in their .xinitrc
files:

	xvt -geometry 80x13+0+0 -fn 5x7 -e sh /etc/startx

This runs my startx script in an Xvt terminal window. You could easily
just put all the stuff in startx straight into the .xinitrc file,
I don't because startx is needed by all users, and they may wish to
change the rest of their configuration....

How To Do Your Own Keymap Script
=================================

If ukXkbd.map didn't fix your keyboard, you will have to write your
own script in the same format to do the job. It takes a while, but
isn't difficult.

The line 'pointer = 1 3 2' changes the mouse button assignments,
as I happen to need middle button access (X terms have 3 button mice).

The rest of the file consists of assignments of the form 

	keycode Xscancode = symbol_name [shifted_symbol_name]

shifted_symbol_name can be ommited, and will leave the shifted
symbol unchanged.

eg.
	keycode 140 = minus plus

The symbol names can be found in the file keysymdefs.h, where
they are specified with an XK_ prefix. When used in xmodmap
scripts you omit the prefix, so if s symbol is listed in keysymdefs.h
as XK_sterling you would use the name sterling in an xmodmap
script.

The Xscancodes can be found using Xev. First, get a bit of paper & a
pen. Then run Xev. Now point at the Xev window & type the key which
you want to change the mapping of. The Xscancode will be reported
by Xev as well as the current symbol assigned to this scan code.
Write it down. When you've got all the codes, you can write the
script. That's how I did it anyway....

Craig.
craig.graham@newcastle.ac.uk

