[PATCH] XKB-Config.xml: update for current releases

[Alan Coopersmith]

Julien Cristau wrote:
> On Mon, Nov  1, 2010 at 19:42:09 -0700, Alan Coopersmith wrote:
> 
>> -    Option "XkbKeycodes" "xorg"
>> +    Option "XkbKeycodes" "xfree86"
>>      Option "XkbTypes"    "default"
>>      Option "XkbSymbols"  "en_US(pc104)+de+swapcaps"
>>      Option "XkbGeometry" "pc(pc104)"
> 
> These options don't exist anymore in the kbd driver, and were never
> supported by evdev, iirc, so that should probably go away.

Oops, I'd forgotten about that.   Looks like the whole section of
"Direct XKB Configuration" should just be removed then, right?

----

Direct XKB Configuration

Generally, you can directly prescribe what configuration of each of basic xkb
components should be used to form the resulting keyboard mapping. This method
is rather “brute force”. You precisely need to know the structure and the
meaning of all of used configuration components.

This method also exposes all xkb configuration details directly into xorg.conf
configuration file which is a not very fortunate fact. In rare occasions it may
be needed, though. So how does it work?

Basic Components

There are five basic components used to form a keyboard mapping:

              a translation of the scan codes produced by the keyboard into a
key codes     suitable symbolic form

types         a specification of what various combinations of modifiers produce

key symbols   a translation of symbolic key codes into actual symbols

geometry      a description of physical keyboard geometry

compatibility a specification of what action should each key produce in order
maps          to preserve compatibility with XKB-unware clients

Example Configuration

Look at the following example:

Section "InputClass"
    Identifier        "keyboard defaults"
    MatchIsKeyboard   "on"

    Option "XkbKeycodes" "xfree86"
    Option "XkbTypes"    "default"
    Option "XkbSymbols"  "en_US(pc104)+de+swapcaps"
    Option "XkbGeometry" "pc(pc104)"
    Option "XkbCompat"   "basic+pc+iso9995"
EndSection


This configuration sets the standard X server default interpretation of
keyboard keycodes, and sets the default modifier types. The symbol table is
composed of extended US keyboard layout in its variant for pc keyboards with
104 keys plus all keys for german layout are redefined respectively. Also the
logical meaning of Caps-lock and Control keys is swapped. The standard keyboard
geometry (physical look) is set to pc style keyboard with 104 keys. The
compatibility map is set to allow basic shifting, to allow Alt keys to be
interpreted and also to allow iso9995 group shifting.

-- 
	-Alan Coopersmith-        alan.coopersmith at oracle.com
	 Oracle Solaris Platform Engineering: X Window System