xorg-xorgproto/include
Oliver Gerlich d466a25c87 keysyms: add missing keys that were added in Linux kernel 2.5.26
Some keysyms were renamed compared to their Linux kernel counterparts,
to avoid names that are too ambiguous. Names are inspired by the “HID
usage table for USB”.

Some keys were left unmapped due to their ambiguous function.

Also fixed the keysyms script to handle minor new use cases.

Miscellaneous notes:
- `KEY_CHANNEL`: Described as “Go to the next favorite channel” in the
  Linux RC tables, thus mapped to `XF86XK_NextFavorite`.
- `KEY_PVR`: The accronym means “personal video recorder”, but there
  are multiple comments in the kernel refering to it as “Media Select
  Home”.
- `KEY_MODE`: Described as labelled "MONO/STEREO" with the function
  "Change sound mode" in the Linux RC tables, thus mapped to the more
  explicit `XF86XK_AudioChannelMode`.
- `KEY_DIGITS`: Describe as “Use more than one digit for channel”, it
  denotes various number entry modes that depend on the device, thus
  mapped to the more explicit `XF86XK_NumberEntryMode`, inspired by its
  entry in the CEC protocol.

Resources:
- Linux Remote controller tables:
  https://www.kernel.org/doc/html/v6.14/userspace-api/media/rc/rc-tables.html
- Linux HID key mmappings:
  https://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git/tree/drivers/hid/hid-input.c
- HID Usage Tables for USB:
  https://usb.org/sites/default/files/hut1_6.pdf
- Kodi: https://github.com/xbmc/xbmc

Co-authored-by: Oliver Gerlich <oliver.gerlich@gmx.de>
Co-authored-by: Pierre Le Marre <dev@wismill.eu>
Part-of: <https://gitlab.freedesktop.org/xorg/proto/xorgproto/-/merge_requests/93>
2025-07-20 20:39:13 +02:00
..
GL Fix spelling/wording issues 2020-08-08 10:33:56 -07:00
X11 keysyms: add missing keys that were added in Linux kernel 2.5.26 2025-07-20 20:39:13 +02:00
meson.build meson: Spread the install rules into their subdirs 2018-02-01 15:01:56 -05:00