Update docs on special characters

This commit is contained in:
sezanzeb 2021-11-21 23:33:15 +01:00
parent ce223646ee
commit 6484ab4972
3 changed files with 14 additions and 8 deletions

View File

@ -410,7 +410,7 @@ class _Groups:
def __getattribute__(self, key):
"""To lazy load group info only when needed.
For example, this helps to keep of key-mapper-control clear when it doesnt
For example, this helps to keep logs of key-mapper-control clear when it doesnt
need it the information.
"""
if key == "_groups" and object.__getattribute__(self, "_groups") is None:

View File

@ -51,7 +51,7 @@ class SystemMapping:
def __getattribute__(self, key):
"""To lazy load system_mapping info only when needed.
For example, this helps to keep of key-mapper-control clear when it doesnt
For example, this helps to keep logs of key-mapper-control clear when it doesnt
need it the information.
"""
if key == "_mapping" and object.__getattribute__(self, "_mapping") is None:

View File

@ -87,12 +87,18 @@ names can be chained using ` + `.
Check the autocompletion of the GUI for possible values. You can also
obtain a complete list of possiblities using `key-mapper-control --symbol-names`.
The available symbols depend on the environments keyboard layout. For example,
mapping a key to an exclamation mark is not possible if the keyboard layout is set
to german. However, it is possible to mimic the combination that would be required
to write it, by writing `Shift_L + 1` into the mapping. This is because key-mapper
creates a new virtual keyboard and injects numeric keycodes (with the benefit of being
compatible to all display servers).
The available symbols depend on the environments keyboard layout, and only those that
don't require a combination to be pressed can be used without workarounds (so most
special characters need some extra steps to use them). This is because key-mapper
acts like a keyboard device. Furthermore, if your configured keyboard layout doesn't
support the special character at all (not even via a combination), then it also won't
be possible for key-mapper to map that character at all.
For example, mapping a key to an exclamation mark is not possible if the keyboard
layout is set to german. However, it is possible to mimic the combination that would
be required to write it, by writing `Shift_L + 1` into the mapping. This is because
key-mapper creates a new virtual keyboard and injects numeric keycodes (with the
benefit of being compatible to all display servers).
Key names that start with `KEY_` are keyboard layout independent constants that might
not result in the expected output. For example using `KEY_Y` would result in "z"