first commit

xim/xcb-util/README.md

@@ -0,0 +1,41 @@
+About XCB util modules
+======================
+
+The XCB util modules provides a number of libraries which sit on top
+of libxcb, the core X protocol library, and some of the extension
+libraries. These experimental libraries provide convenience functions
+and interfaces which make the raw X protocol more usable. Some of the
+libraries also provide client-side code which is not strictly part of
+the X protocol but which have traditionally been provided by Xlib.
+
+If you find any of these libraries useful, please let us know what
+you're using and why you aren't in a mental hospital yet. We'd welcome
+patches/suggestions for enhancement and new libraries; Please report any
+issues you find to the freedesktop.org bug tracker, at:
+
+  https://gitlab.freedesktop.org/xorg/lib/libxcb-util/-/issues
+
+Discussion about XCB occurs on the XCB mailing list:
+
+  https://lists.freedesktop.org/mailman/listinfo/xcb
+
+About XCB util module
+=====================
+
+XCB util module provides the following libraries:
+
+  - aux: Convenient access to connection setup and some core requests.
+  - atom: Standard core X atom constants and atom caching.
+  - event: Some utilities that have little to do with events any more.
+
+You can obtain the latest development versions of XCB util using GIT from:
+
+  https://gitlab.freedesktop.org/xorg/lib/libxcb-util
+
+  For anonymous checkouts, use:
+
+    git clone --recursive https://gitlab.freedesktop.org/xorg/lib/libxcb-util.git
+
+  For developers, use:
+
+    git clone --recursive git@gitlab.freedesktop.org:xorg/lib/libxcb-util.git