xenocara/proto/xorgproto
purplerain 155eb8555e
sync with OpenBSD -current
2024-04-29 00:35:41 +00:00
..
include sync with OpenBSD -current 2024-04-29 00:35:41 +00:00
man sync code with last improvements from OpenBSD 2023-08-28 05:57:34 +00:00
scripts sync code with last improvements from OpenBSD 2023-08-28 05:57:34 +00:00
specs sync code with last improvements from OpenBSD 2023-08-28 05:57:34 +00:00
AUTHORS sync code with last improvements from OpenBSD 2023-08-28 05:57:34 +00:00
COPYING-applewmproto sync code with last improvements from OpenBSD 2023-08-28 05:57:34 +00:00
COPYING-bigreqsproto sync code with last improvements from OpenBSD 2023-08-28 05:57:34 +00:00
COPYING-compositeproto sync code with last improvements from OpenBSD 2023-11-11 18:37:37 +00:00
COPYING-damageproto sync code with last improvements from OpenBSD 2023-08-28 05:57:34 +00:00
COPYING-dmxproto sync code with last improvements from OpenBSD 2023-08-28 05:57:34 +00:00
COPYING-dri2proto sync code with last improvements from OpenBSD 2023-08-28 05:57:34 +00:00
COPYING-dri3proto sync code with last improvements from OpenBSD 2023-08-28 05:57:34 +00:00
COPYING-evieproto sync code with last improvements from OpenBSD 2023-11-11 18:37:37 +00:00
COPYING-fixesproto sync code with last improvements from OpenBSD 2023-11-11 18:37:37 +00:00
COPYING-fontcacheproto sync code with last improvements from OpenBSD 2023-08-28 05:57:34 +00:00
COPYING-fontsproto sync code with last improvements from OpenBSD 2023-08-28 05:57:34 +00:00
COPYING-glproto sync code with last improvements from OpenBSD 2023-08-28 05:57:34 +00:00
COPYING-inputproto sync code with last improvements from OpenBSD 2023-08-28 05:57:34 +00:00
COPYING-kbproto sync code with last improvements from OpenBSD 2023-08-28 05:57:34 +00:00
COPYING-lg3dproto sync code with last improvements from OpenBSD 2023-08-28 05:57:34 +00:00
COPYING-pmproto sync code with last improvements from OpenBSD 2023-08-28 05:57:34 +00:00
COPYING-presentproto sync code with last improvements from OpenBSD 2023-08-28 05:57:34 +00:00
COPYING-printproto sync code with last improvements from OpenBSD 2023-11-11 18:37:37 +00:00
COPYING-randrproto sync code with last improvements from OpenBSD 2023-08-28 05:57:34 +00:00
COPYING-recordproto sync code with last improvements from OpenBSD 2023-08-28 05:57:34 +00:00
COPYING-renderproto sync code with last improvements from OpenBSD 2023-08-28 05:57:34 +00:00
COPYING-resourceproto sync code with last improvements from OpenBSD 2023-08-28 05:57:34 +00:00
COPYING-scrnsaverproto sync code with last improvements from OpenBSD 2023-08-28 05:57:34 +00:00
COPYING-trapproto sync code with last improvements from OpenBSD 2023-08-28 05:57:34 +00:00
COPYING-videoproto sync code with last improvements from OpenBSD 2023-08-28 05:57:34 +00:00
COPYING-windowswmproto sync code with last improvements from OpenBSD 2023-08-28 05:57:34 +00:00
COPYING-x11proto sync code with last improvements from OpenBSD 2023-11-11 18:37:37 +00:00
COPYING-xcmiscproto sync code with last improvements from OpenBSD 2023-08-28 05:57:34 +00:00
COPYING-xextproto sync code with last improvements from OpenBSD 2023-08-28 05:57:34 +00:00
COPYING-xf86bigfontproto sync code with last improvements from OpenBSD 2023-08-28 05:57:34 +00:00
COPYING-xf86dgaproto sync code with last improvements from OpenBSD 2023-08-28 05:57:34 +00:00
COPYING-xf86driproto sync code with last improvements from OpenBSD 2023-08-28 05:57:34 +00:00
COPYING-xf86miscproto sync code with last improvements from OpenBSD 2023-08-28 05:57:34 +00:00
COPYING-xf86rushproto sync code with last improvements from OpenBSD 2023-08-28 05:57:34 +00:00
COPYING-xf86vidmodeproto sync code with last improvements from OpenBSD 2023-08-28 05:57:34 +00:00
COPYING-xineramaproto sync code with last improvements from OpenBSD 2023-08-28 05:57:34 +00:00
COPYING-xwaylandproto sync code with last improvements from OpenBSD 2023-08-28 05:57:34 +00:00
INSTALL sync code with last improvements from OpenBSD 2023-08-28 05:57:34 +00:00
Makefile.am sync code with last improvements from OpenBSD 2023-11-11 18:37:37 +00:00
Makefile.bsd-wrapper sync code with last improvements from OpenBSD 2023-08-28 05:57:34 +00:00
Makefile.in sync code with last improvements from OpenBSD 2023-08-28 05:57:34 +00:00
PM_spec sync code with last improvements from OpenBSD 2023-08-28 05:57:34 +00:00
README.md sync code with last improvements from OpenBSD 2023-08-28 05:57:34 +00:00
aclocal.m4 sync code with last improvements from OpenBSD 2023-11-11 18:37:37 +00:00
applewmproto.pc.in sync code with last improvements from OpenBSD 2023-08-28 05:57:34 +00:00
autogen.sh sync code with last improvements from OpenBSD 2023-08-28 05:57:34 +00:00
bigreqsproto.pc.in sync code with last improvements from OpenBSD 2023-08-28 05:57:34 +00:00
compile sync code with last improvements from OpenBSD 2023-08-28 05:57:34 +00:00
compositeproto.pc.in sync code with last improvements from OpenBSD 2023-08-28 05:57:34 +00:00
compositeproto.txt sync code with last improvements from OpenBSD 2023-08-28 05:57:34 +00:00
config.guess sync with OpenBSD -current 2024-04-29 00:35:41 +00:00
config.sub sync code with last improvements from OpenBSD 2023-08-28 05:57:34 +00:00
configure sync code with last improvements from OpenBSD 2023-11-11 18:37:37 +00:00
configure.ac sync code with last improvements from OpenBSD 2023-11-11 18:37:37 +00:00
damageproto.pc.in sync code with last improvements from OpenBSD 2023-08-28 05:57:34 +00:00
damageproto.txt sync code with last improvements from OpenBSD 2023-08-28 05:57:34 +00:00
dmxproto.pc.in sync code with last improvements from OpenBSD 2023-08-28 05:57:34 +00:00
docbook.am sync code with last improvements from OpenBSD 2023-08-28 05:57:34 +00:00
dpmsproto.pc.in sync code with last improvements from OpenBSD 2023-08-28 05:57:34 +00:00
dri2proto.pc.in sync code with last improvements from OpenBSD 2023-08-28 05:57:34 +00:00
dri2proto.txt sync code with last improvements from OpenBSD 2023-08-28 05:57:34 +00:00
dri3proto.pc.in sync code with last improvements from OpenBSD 2023-08-28 05:57:34 +00:00
dri3proto.txt sync code with last improvements from OpenBSD 2023-11-11 18:37:37 +00:00
evieproto.pc.in sync code with last improvements from OpenBSD 2023-08-28 05:57:34 +00:00
fixesproto.pc.in sync code with last improvements from OpenBSD 2023-11-11 18:37:37 +00:00
fixesproto.txt sync code with last improvements from OpenBSD 2023-11-11 18:37:37 +00:00
fontcacheproto.pc.in sync code with last improvements from OpenBSD 2023-08-28 05:57:34 +00:00
fontsproto.pc.in sync code with last improvements from OpenBSD 2023-08-28 05:57:34 +00:00
glproto.pc.in sync code with last improvements from OpenBSD 2023-08-28 05:57:34 +00:00
inputproto.pc.in sync code with last improvements from OpenBSD 2023-08-28 05:57:34 +00:00
install-sh sync code with last improvements from OpenBSD 2023-08-28 05:57:34 +00:00
kbproto.pc.in sync code with last improvements from OpenBSD 2023-08-28 05:57:34 +00:00
lg3dproto.pc.in sync code with last improvements from OpenBSD 2023-08-28 05:57:34 +00:00
meson.build sync code with last improvements from OpenBSD 2023-11-11 18:37:37 +00:00
meson_options.txt sync code with last improvements from OpenBSD 2023-08-28 05:57:34 +00:00
missing sync code with last improvements from OpenBSD 2023-08-28 05:57:34 +00:00
presentproto.pc.in sync code with last improvements from OpenBSD 2023-11-11 18:37:37 +00:00
presentproto.txt sync code with last improvements from OpenBSD 2023-11-11 18:37:37 +00:00
printproto.pc.in sync code with last improvements from OpenBSD 2023-08-28 05:57:34 +00:00
randrproto.pc.in sync code with last improvements from OpenBSD 2023-08-28 05:57:34 +00:00
randrproto.txt sync code with last improvements from OpenBSD 2023-11-11 18:37:37 +00:00
recordproto.pc.in sync code with last improvements from OpenBSD 2023-08-28 05:57:34 +00:00
renderproto.pc.in sync code with last improvements from OpenBSD 2023-08-28 05:57:34 +00:00
renderproto.txt sync code with last improvements from OpenBSD 2023-08-28 05:57:34 +00:00
resourceproto.pc.in sync code with last improvements from OpenBSD 2023-08-28 05:57:34 +00:00
resproto.txt sync code with last improvements from OpenBSD 2023-08-28 05:57:34 +00:00
scrnsaverproto.pc.in sync code with last improvements from OpenBSD 2023-08-28 05:57:34 +00:00
test-driver sync code with last improvements from OpenBSD 2023-08-28 05:57:34 +00:00
trapproto.pc.in sync code with last improvements from OpenBSD 2023-08-28 05:57:34 +00:00
videoproto.pc.in sync code with last improvements from OpenBSD 2023-08-28 05:57:34 +00:00
windowswmproto.pc.in sync code with last improvements from OpenBSD 2023-08-28 05:57:34 +00:00
xcalibrateproto.pc.in sync code with last improvements from OpenBSD 2023-08-28 05:57:34 +00:00
xcmiscproto.pc.in sync code with last improvements from OpenBSD 2023-08-28 05:57:34 +00:00
xextproto.pc.in sync code with last improvements from OpenBSD 2023-08-28 05:57:34 +00:00
xf86bigfontproto.pc.in sync code with last improvements from OpenBSD 2023-08-28 05:57:34 +00:00
xf86dgaproto.pc.in sync code with last improvements from OpenBSD 2023-08-28 05:57:34 +00:00
xf86driproto.pc.in sync code with last improvements from OpenBSD 2023-08-28 05:57:34 +00:00
xf86miscproto.pc.in sync code with last improvements from OpenBSD 2023-08-28 05:57:34 +00:00
xf86rushproto.pc.in sync code with last improvements from OpenBSD 2023-08-28 05:57:34 +00:00
xf86vidmodeproto.pc.in sync code with last improvements from OpenBSD 2023-08-28 05:57:34 +00:00
xineramaproto.pc.in sync code with last improvements from OpenBSD 2023-08-28 05:57:34 +00:00
xproto.pc.in sync code with last improvements from OpenBSD 2023-08-28 05:57:34 +00:00
xproxymngproto.pc.in sync code with last improvements from OpenBSD 2023-08-28 05:57:34 +00:00
xv-protocol-v2.txt sync code with last improvements from OpenBSD 2023-08-28 05:57:34 +00:00
xwaylandproto.pc.in sync code with last improvements from OpenBSD 2023-08-28 05:57:34 +00:00
xwaylandproto.txt sync code with last improvements from OpenBSD 2023-08-28 05:57:34 +00:00

README.md

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_FOO defines, 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.py to add new keysyms. See the --help output 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.