===================================================================
RCS file: /cvsrepo/anoncvs/cvs/xenocara/README,v
retrieving revision 1.41
retrieving revision 1.42
diff -u -r1.41 -r1.42
--- xenocara/README	2018/05/20 17:25:01	1.41
+++ xenocara/README	2018/07/19 12:14:37	1.42
@@ -148,6 +148,25 @@
  cd XSRCDIR
  cvs -q update -PAd -I - | awk '$1=="?" {print $2}' | xargs rm -f
 
+o Updating XCB to a new release
+  -----------------------------
+
+libxcb uses C source files that are generated from the XML protocol
+specification using xcbgen, written in Python. On OpenBSD those files
+cannot be generated during a normal 'make build' since Python is not
+in the base system. So the generated version are checked in CVS
+(in lib/libxcb/src/). Here is the receipt to update them when updating
+to a new release of XCB:
+
+1) Update proto/xcb-proto.
+2) Update the x11/py-xcbgen port to the same version and install the
+   package.
+3) Update dist/libxcb.
+4) Check lib/libxcb/src/Makefile if new files need to be generated.
+5) Run 'make' in lib/xcb/src to generate the files for the new version.
+6) Check lib/libxcb/ for other files needing updates.
+7) Commit the result.
+
 o How to build something with debug information?
   ----------------------------------------------
 
@@ -192,4 +211,4 @@
 See also <http://xorg.freedesktop.org/wiki/Development/Documentation/ServerDebugging>
 
 -- 
-$OpenBSD: README,v 1.41 2018/05/20 17:25:01 matthieu Exp $
+$OpenBSD: README,v 1.42 2018/07/19 12:14:37 matthieu Exp $