openbsd-xenocara/proto/xcb-proto
matthieu ea5427c3e1 Missed this file in the xcb-protos 1.5.2 update 2022-07-18 06:21:45 +00:00
..
doc Update xcb-protos to 1.15.2 2022-07-17 08:19:03 +00:00
src Update xcb-protos to 1.15.2 2022-07-17 08:19:03 +00:00
xcbgen Update xcb-protos to 1.15.2 2022-07-17 08:19:03 +00:00
COPYING initial import of xcb-proto 1.4 2009-05-22 15:48:38 +00:00
INSTALL initial import of xcb-proto 1.4 2009-05-22 15:48:38 +00:00
Makefile Missed this file in the xcb-protos 1.5.2 update 2022-07-18 06:21:45 +00:00
Makefile.am Update xcb-protos to 1.15.2 2022-07-17 08:19:03 +00:00
Makefile.in initial import of xcb-proto 1.4 2009-05-22 15:48:38 +00:00
NEWS Update to xcb-proto 1.14.1. No functional changes. 2020-12-13 10:56:06 +00:00
README.md Update to libxcb 1.14 and xcb-proto 1.14. ok tb@ 2020-05-16 08:49:00 +00:00
TODO initial import of xcb-proto 1.4 2009-05-22 15:48:38 +00:00
aclocal.m4 initial import of xcb-proto 1.4 2009-05-22 15:48:38 +00:00
autogen.sh Update to xcb-proto 1.10 2014-03-15 17:24:19 +00:00
configure initial import of xcb-proto 1.4 2009-05-22 15:48:38 +00:00
configure.ac Update xcb-protos to 1.15.2 2022-07-17 08:19:03 +00:00
install-sh initial import of xcb-proto 1.4 2009-05-22 15:48:38 +00:00
missing initial import of xcb-proto 1.4 2009-05-22 15:48:38 +00:00
py-compile Update xcb-protos to 1.15.2 2022-07-17 08:19:03 +00:00
xcb-proto.pc.in Update xcb-protos to 1.15.2 2022-07-17 08:19:03 +00:00

README.md

About xcb-proto

xcb-proto provides the XML-XCB protocol descriptions that libxcb uses to generate the majority of its code and API. We provide them separately from libxcb to allow reuse by other projects, such as additional language bindings, protocol dissectors, or documentation generators.

This separation between the XCB transport layer and the automatically-generated protocol layer also makes it far easier to write new extensions. With the Xlib infrastructure, client-side support for new extensions requires significant duplication of effort. With XCB and the XML-XCB protocol descriptions, client-side support for a new extension requires only an XML description of the extension, and not a single line of code.

Python libraries: xcb-proto also contains language-independent Python libraries that are used to parse an XML description and create objects used by Python code generators in individual language bindings. These libraries are installed into $(prefix)/lib/pythonX.X/site-packages. If this location is not on your system's Python path, scripts that import them will fail with import errors. In this case you must add the install location to your Python path by creating a file with a `.pth' extension in a directory that is on the Python path, and put the path to the install location in that file. For example, on my system there is a file named 'local.pth' in /usr/lib/python2.5/site-packages, which contains '/usr/local/lib/python2.5/site-packages'. Note that this is only necessary on machines where XCB is being built.

Please report any issues you find to the freedesktop.org bug tracker at:

https://gitlab.freedesktop.org/xorg/proto/xcbproto/issues

Discussion about XCB occurs on the XCB mailing list:

https://lists.freedesktop.org/mailman/listinfo/xcb

You can obtain the latest development versions of xcb-proto using GIT from the xcbproto code repository at:

https://gitlab.freedesktop.org/xorg/proto/xcbproto

For anonymous checkouts, use:

git clone https://gitlab.freedesktop.org/xorg/proto/xcbproto.git

For developers, use:

git clone git@gitlab.freedesktop.org:xorg/proto/xcbproto.git