summaryrefslogtreecommitdiff
path: root/console-client/xkb/HACKING
diff options
context:
space:
mode:
Diffstat (limited to 'console-client/xkb/HACKING')
-rw-r--r--console-client/xkb/HACKING35
1 files changed, 35 insertions, 0 deletions
diff --git a/console-client/xkb/HACKING b/console-client/xkb/HACKING
new file mode 100644
index 00000000..c4362347
--- /dev/null
+++ b/console-client/xkb/HACKING
@@ -0,0 +1,35 @@
+
+Syncronizing External Sources
+-----------------------------
+
+Some source files are pristinely copied from several Xorg repositories
+and they must be syncronized with each Xorg release to get new features.
+
+The following list details the syncronization procedure of every foreign
+resource. Additionally, the version the resource was last syncronized to
+is located next to the file name.
+
+ * xproto-7.0.18 (keysymdef.h): copied from source tree.
+
+ $ git clone git://anongit.freedesktop.org/git/xorg/proto/x11proto
+ $ cd x11proto
+ $ git checkout [latest-tag]
+ $ cp keysymdef.h $TARGET/keysymdef.h
+
+ * libX11-1.3.99.901 (ks_tables.h): generated by build process.
+
+ $ git clone git://anongit.freedesktop.org/xorg/util/macros
+ $ git clone git://anongit.freedesktop.org/xorg/lib/libX11
+ $ cd macros
+ $ ./autogen.sh && ./configure && make
+ $ cd ../libX11
+ $ ACLOCAL="aclocal -I ../macros" ./autogen.sh && ./configure
+ $ make -C src ks_tables.h
+ $ cp src/ks_tables.h $TARGET/ks_tables.h
+
+Other sources must be modified before the driver can use them. Thus, the
+update procedure cannot be fully automated.
+
+ * libX11-1.3.99.901 (symname.c): based on src/StrKeysym.c
+ (kstoucs.c): based on src/xlibi18n/imKStoUCS.c
+