diff options
Diffstat (limited to 'README.enhancing')
| -rw-r--r-- | README.enhancing | 44 |
1 files changed, 21 insertions, 23 deletions
diff --git a/README.enhancing b/README.enhancing index db78026..3ce2b34 100644 --- a/README.enhancing +++ b/README.enhancing @@ -24,7 +24,7 @@ A useful source is also Ivan Pascal's text about xkb configuration ment. Note that this document covers only enhancements which are to be made to -XFree86 version 4.3.x and above. +XFree86 version 4.3 and X11R6.7.0 and above. 2. The Basics @@ -104,10 +104,10 @@ tricks. 3.1 Levels And Groups -Since XFree86 4.3.0 you can use multi-layout concept of xkb configuration. -Though it is still in boundaries of xkb protocol and general ideas, the -keymap designer must obey new rules when creating new maps. In exchange we -get a more powerful and cleaner configuration system. +Since XFree86 4.3.0 and X11R6.7.0 you can use multi-layout concept of xkb +configuration. Though it is still in boundaries of xkb protocol and general +ideas, the keymap designer must obey new rules when creating new maps. In +exchange we get a more powerful and cleaner configuration system. Remember that it is the application which must decide which symbol matches which keycode according to effective modifier state. The X server itself @@ -124,7 +124,7 @@ modifiers. <ENTER> key, for instance, usually doesn't depend on any modi- fiers so it its row has only one column defined. Note that in XKB there is no prior assumption that certain modifiers are -bound to certain columns. By editing proper files (see keytypes (section 4.2, +bound to certain columns. By editing proper files (see refnam (section 4.2, page 1)) this mapping can be changed as well. Unlike the original X protocol the XKB approach is far more flexible. It is @@ -132,12 +132,12 @@ comfortable to add one additional XKB term - group. You can think of a group as of a vector of columns per each keycode (naturally the dimension of this vector may differ for different keycodes). What is it good for? The group is not very useful unless you intend to use more than one logically different -set of symbols (like more than one alphabet) defined in a single mapping ta- -ble. But then, the group has a natural meaning - each symbol set has its own -group and changing it means selecting a different one. XKB approach allows -up to four different groups. The columns inside each group are called (shift) -levels. The X server knows the current group and reports it together with -modifier set and with a keycode in key events. +set of symbols (like more than one alphabet) defined in a single mapping +table. But then, the group has a natural meaning - each symbol set has its +own group and changing it means selecting a different one. XKB approach +allows up to four different groups. The columns inside each group are called +(shift) levels. The X server knows the current group and reports it together +with modifier set and with a keycode in key events. To sum it up: @@ -223,9 +223,9 @@ altering what may be needed. The differences in the number of columns (shift levels) are caused by a dif- ferent types of keys (see the types definition in section basics). Most key- -codes have implicitly set the keytype in the included "pc/latin" file to -"FOUR_LEVEL_ALPHABETIC". The only exception is <RALT> keycode which is -explicitly set "TWO_LEVEL" keytype. +codes have implicitly set the keytype in the included 'pc/latin' file to +'FOUR_LEVEL_ALPHABETIC'. The only exception is <RALT> keycode which is +explicitly set 'TWO_LEVEL' keytype. All those names refer to pre-defined shift level schemes. Usually you can choose a suitable shift level scheme from default types scheme list in proper @@ -423,7 +423,7 @@ this: ! model = keycodes macintosh_old = macintosh ... - * = xfree86 + * = xorg ! model = symbols hp = +inet(%m) @@ -446,10 +446,10 @@ Each rule defines what certain combination of values on the left side of equal sign ('=') results in. For example a (keyboard) model macintosh_old instructs xkb to take definitions of keycodes from file keycodes/macintosh while the rest of models (represented by a wild card '*') instructs it to -take them from file keycodes/xfree86. The wild card represents all possible -values on the left side which were not found in any of the previous rules. -The more specialized (more complete) rules have higher precedence than gen- -eral ones, i.e. the more general rules supply reasonable default values. +take them from file keycodes/xorg. The wild card represents all possible val- +ues on the left side which were not found in any of the previous rules. The +more specialized (more complete) rules have higher precedence than general +ones, i.e. the more general rules supply reasonable default values. As you can see some lines contain substitution parameters - the parameters preceded by the percent sign ('%'). The first alphabetical character after @@ -505,7 +505,5 @@ rules file described above the .lst file could look like: And that should be it. Enjoy creating your own xkb mapping. - Generated from XFree86: xc/programs/Xserver/hw/xfree86/doc/sgml/XKB-Enhancing.sgml,v 1.2 dawes Exp $ - -$XFree86: $ +$XdotOrg: xc/programs/xkbcomp/README.enhancing,v 1.3 2004/09/03 23:41:22 kem Exp $ |