mirror of
https://gitlab.freedesktop.org/xorg/proto/xorgproto.git
synced 2025-12-20 02:20:17 +01:00
read-only mirror of https://gitlab.freedesktop.org/xorg/proto/xorgproto
e9a98ce6a7
Recent removals & deprecations of keysyms have caused quite a lot of trouble: - Removed keysyms *were* used in the wild, especially the dead keys: e.g. in Neo-like and Bépo-like layouts. While checking for keysyms use in xkeyboard-config database is a mandatory first step, it is not enough. - Removed keysyms broke Qt build. - Deprecated names are now replaced by their new non-deprecated version. It is problematic in the case that a sandbox application (e.g. with flatpak) uses X11 or xkbcommon libraries older than the system’s one: they are not able to parse the new names. For the sake of the stability, this commit restore all previous keysyms and introduces the new names as alternative. While the comments mark some names as “deprecated”, they will remain the canonical names (i.e. they are *output* by `xkbcomp` and `xkbcommon`) for the next 10 years. Details of the modified commits: - "keysymdef.h: add better names for the dead schwa and SCHWA symbols" (commit |
||
|---|---|---|
| attic | ||
| include | ||
| man | ||
| scripts | ||
| specs | ||
| .gitignore | ||
| .gitlab-ci.yml | ||
| applewmproto.pc.in | ||
| AUTHORS | ||
| autogen.sh | ||
| bigreqsproto.pc.in | ||
| compositeproto.pc.in | ||
| compositeproto.txt | ||
| configure.ac | ||
| COPYING-applewmproto | ||
| COPYING-bigreqsproto | ||
| COPYING-compositeproto | ||
| COPYING-damageproto | ||
| COPYING-dmxproto | ||
| COPYING-dri2proto | ||
| COPYING-dri3proto | ||
| COPYING-evieproto | ||
| COPYING-fixesproto | ||
| COPYING-fontcacheproto | ||
| COPYING-fontsproto | ||
| COPYING-glproto | ||
| COPYING-inputproto | ||
| COPYING-kbproto | ||
| COPYING-lg3dproto | ||
| COPYING-pmproto | ||
| COPYING-presentproto | ||
| COPYING-printproto | ||
| COPYING-randrproto | ||
| COPYING-recordproto | ||
| COPYING-renderproto | ||
| COPYING-resourceproto | ||
| COPYING-scrnsaverproto | ||
| COPYING-trapproto | ||
| COPYING-videoproto | ||
| COPYING-windowswmproto | ||
| COPYING-x11proto | ||
| COPYING-xcmiscproto | ||
| COPYING-xextproto | ||
| COPYING-xf86bigfontproto | ||
| COPYING-xf86dgaproto | ||
| COPYING-xf86driproto | ||
| COPYING-xf86miscproto | ||
| COPYING-xf86rushproto | ||
| COPYING-xf86vidmodeproto | ||
| COPYING-xineramaproto | ||
| COPYING-xwaylandproto | ||
| damageproto.pc.in | ||
| damageproto.txt | ||
| dmxproto.pc.in | ||
| docbook.am | ||
| dpmsproto.pc.in | ||
| dri2proto.pc.in | ||
| dri2proto.txt | ||
| dri3proto.pc.in | ||
| dri3proto.txt | ||
| evieproto.pc.in | ||
| fixesproto.pc.in | ||
| fixesproto.txt | ||
| fontcacheproto.pc.in | ||
| fontsproto.pc.in | ||
| glproto.pc.in | ||
| inputproto.pc.in | ||
| INSTALL | ||
| kbproto.pc.in | ||
| lg3dproto.pc.in | ||
| Makefile.am | ||
| meson.build | ||
| meson_options.txt | ||
| PM_spec | ||
| presentproto.pc.in | ||
| presentproto.txt | ||
| printproto.pc.in | ||
| randrproto.pc.in | ||
| randrproto.txt | ||
| README.md | ||
| recordproto.pc.in | ||
| renderproto.pc.in | ||
| renderproto.txt | ||
| resourceproto.pc.in | ||
| resproto.txt | ||
| scrnsaverproto.pc.in | ||
| trapproto.pc.in | ||
| videoproto.pc.in | ||
| windowswmproto.pc.in | ||
| xcalibrateproto.pc.in | ||
| xcmiscproto.pc.in | ||
| xextproto.pc.in | ||
| xf86bigfontproto.pc.in | ||
| xf86dgaproto.pc.in | ||
| xf86driproto.pc.in | ||
| xf86miscproto.pc.in | ||
| xf86rushproto.pc.in | ||
| xf86vidmodeproto.pc.in | ||
| xineramaproto.pc.in | ||
| xproto.pc.in | ||
| xproxymngproto.pc.in | ||
| xv-protocol-v2.txt | ||
| xwaylandproto.pc.in | ||
| xwaylandproto.txt | ||
X Window System Unified Protocol
This package provides the headers and specification documents defining the core protocol and (many) extensions for the X Window System. The extensions are those common among servers descended from X11R7. It also includes a number of headers that aren't purely protocol related, but are depended upon by many other X Window System packages to provide common definitions and porting layer.
Though the protocol specifications herein are authoritative, the content of the headers is bound by compatibility constraints with older versions of the X11 suite. If you are looking for a machine-readable protocol description suitable for code generation or use in new projects, please refer to the XCB project:
https://xcb.freedesktop.org/ https://gitlab.freedesktop.org/xorg/proto/xcbproto
All questions regarding this software should be directed at the Xorg mailing list:
https://lists.x.org/mailman/listinfo/xorg
The primary development code repository can be found at:
https://gitlab.freedesktop.org/xorg/proto/xorgproto
Please submit bug reports and requests to merge patches there.
For patch submission instructions, see:
https://www.x.org/wiki/Development/Documentation/SubmittingPatches
Updating for new Linux kernel releases
The XF86keysym.h header file needs updating whenever the Linux kernel adds a new keycode to linux/input-event-codes.h. See the comment in include/X11/XF86keysym.h for details on the format.
The steps to update the file are:
- if the kernel release did not add new
KEY_FOOdefines, no work is required - ensure that libevdev has been updated to the new kernel headers. This may require installing libevdev from git.
- run
scripts/keysym-generator.pyto add new keysyms. See the--helpoutput for the correct invocation. - verify that the format for any keys added by this script is correct and that the keys need to be mapped. Where a key code should not get a new define or is already defined otherwise, comment the line.
- file a merge request with the new changes
- notify the xkeyboard-config maintainers that updates are needed
Note that any #define added immediately becomes API. Due diligence is recommended.