Le programme xmodmap est utilisé pour éditer et afficher la table des modificateurs du clavier et la table de correspondance utilisées par les applications clientes pour convertir les keycodes (événements clavier) en keysyms (symboles utilisés par les applications clientes). Il est habituellement lancé par le script de démarrage de session de l'utilisateur afin d'accorder le clavier à ses propres goûts.
Les options suivantes peuvent être utilisées avec xmodmap
nom_de_fichier indique un fichier contenant des expressions devant être exécutées par xmodmap. Ce fichier est en général stocké dans le répertoire principal de l'utilisateur sous un nom tel que .xmodmaprc.
Le programme xmodmap lit une liste d'expressions et les analyse toutes avant de tenter d'exécuter l'une d'entre elles. Cela permet de se référer à des keysyms qui ont été redéfinis sans avoir à se préoccuper des conflits de noms.
La liste des keysyms est assignée au keycode indiqué (qui peut être spécifié en décimal, hexa ou octal et peut être déterminé grâce au programme xev)
La liste des noms des keysym peut être trouvée dans le fichier d'en-tête : <X11/keysymdef.h> (sans le prefix XK_) ou dans la base de donnée des keysyms <XRoot>/lib/X11/XKeysymDB, où <XRoot> représente la racine de l'arborescence de l'installation de X11. Notez que si le même keysym est lié à plusieurs touches, l'expression est exécutée pour chaque keycode correspondant.
Cela efface toutes les entrées dans la table de modificateurs pour le modificateur donné, où les noms valides sont : Shift, Lock, Control, Mod1, Mod2, Mod3, Mod4, et Mod5 (la casse n'a pas d'importance dans le nom des modificateurs bien qu'elle en ait pour tous les autres noms). Par exemple, « clear Lock » effacera toutes les touches qui étaient liées au modificateur <<shift lock>>
Les lignes qui commencent par un point d'exclamation (!) sont des commentaires.
Si vous voulez changer le lien d'une touche de modificateur, vous devez l'enlever de la table du modificateur appropriée.
La plupart des pointeurs (souris) sont conçus pour que le premier bouton soit pressé avec l'index de la main droite. Les gauchers trouvent généralement qu'il est plus confortable d'intervertir les codes de boutons générés de manière à ce que le premier bouton soit pressé avec l'index de la main gauche. Cela peut être fait sur une souris à 3 boutons de cette manière :
% xmodmap -e "pointer = 3 2 1"
Beaucoup d'applications supportent la notion de << touche Meta >> (équivalente à la touche Control). Cependant certains serveurs n'ont pas de keysym Meta dans la table des keymap par défaut. Celui-ci doit donc être ajouté manuellement.
La commande suivante attache Meta à la touche Multi-langage (parfois indiquée par Compose). Cela tire avantage du fait que les applications qui ont besoin d'une touche Meta nécessitent simplement d'avoir le keycode et ne requièrent pas que le keysym soit dans la première colonne de la table des keymap. Cela signifie que les applications qui cherchent une touche Multi_key (y compris la table de modificateur par défaut) n'y verront aucun changement.
% xmodmap -e "keysym Multi_key = Multi_key Meta_L"
De la même manière, certain claviers ont une touche Alt, mais pas de touche Meta. Dans ce cas, la commande suivante peut être utile :
% xmodmap -e "keysym Alt_L = Meta_L Alt_L"
Une des plus simples, mais pratique, utilisations de xmodmap
est de changer la touche <Suppr.> (ou <delete>) pour générer un keysym
différent.
Cela implique généralement d'échanger Backspace avec Delete pour plus
de confort d'utilisation. (NDT : C'est à dire : faire que delete efface le
caractère sur le curseur et non le précédent)
Si la ressource ttyModes dans
xterm est positionnée convenablement, toutes les fenêtres
des émulateurs de terminaux utiliseront la même touche pour effacer
les caractères :
% xmodmap -e "keysym BackSpace = Delete" % echo "XTerm*ttyModes: erase ^?" | xrdb -merge
Certains claviers ne génèrent pas automatiquement les caractères "plus petit que <" et "plus grand que >" quand le point et la virgule sont shiftés. On peut remédier à cela avec xmodmap en ré-affectant les touches point et virgule avec le script suivant :
! ! make shift-, be < and shift-. be > ! keysym comma = comma less keysym period = period greater
L'une des plus irritantes différences ente les claviers est la position des touches Control et CapsLock. Une utilisation habituelle de xmodmap est pour échanger ces deux touches :
! ! Swap Caps_Lock and Control_L ! remove Lock = Caps_Lock remove Control = Control_L keysym Control_L = Caps_Lock keysym Caps_Lock = Control_L add Lock = Caps_Lock add Control = Control_L
La commande keycode est très utile pour assigner le même keysym à de multiples keycodes. Bien que non portable, cette méthode rend possible l'écriture de scripts qui peuvent réinitialiser le clavier à un état connu. Le script suivant définit la touche backspace pour générer Delete (comme vu précédemment), flush tous les liens avec caps lock, fait de la touche CapsLock une touche Control, fait que F5 génère Escape, et fait que Break/Reset soit shift lock.
! sur HP, les keycodes suivants sont étiquetés : ! ! 101 Backspace ! 55 Caps ! 14 Ctrl ! 15 Break/Reset ! 86 Stop ! 89 F5 ! keycode 101 = Delete keycode 55 = Control_R clear Lock add Control = Control_R keycode 89 = Escape keycode 15 = Caps_Lock add Lock = Caps_Lock
Chaque fois qu'une expression keycode est évaluée, le serveur génère un événement MappingNotify sur chaque client. Cela peut causer quelques crash. Tous les changements devraient être groupés et exécutés ensembles. Les clients qui reçoivent une entrée clavier et ignorent les événements MappingNotify ne serons pas prévenus des changement effectués aux correspondances clavier.
Xmodmap devrait générer les expressions « add » et « remove » automatiquement toutes les fois ou un keycode déjà lié à un modificateur est changé.
Cela pourrait être une manière pour que l'expression remove accepte les keycodes aussi bien que les keysyms dans le cas ou vous mettriez vraiment le boxon dans les mappings.