summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-rw-r--r--README39
1 files changed, 39 insertions, 0 deletions
diff --git a/README b/README
new file mode 100644
index 000000000..d9fd086e4
--- /dev/null
+++ b/README
@@ -0,0 +1,39 @@
+
+ Notes on building Xenocara for OpenBSD X hackers
+
+This document presents some techniques that can be useful for people
+wanting to hack the xenocara tree. It assumes some basic knowledge of
+the OpenBSD build system, as described in the release(8) manual page.
+
+o About Xenocara
+ --------------
+Xenocara is the name choosen for OpenBSD's version of X. It's
+currently based on X.Org 7.2 and its dependencies. The goal of
+Xenocara is to provide a framework to host local modifications and to
+automate the build of the modular X.Org components, including 3rd
+party packages and some software maintained by OpenBSD developpers.
+
+o Source tree
+ -----------
+
+The organisation of the xenocara directory follows the general
+organisation used in X.Org:
+
+- app: X applications and utilities
+- data: various data files (keyboard mappings and bitmaps)
+- doc: documentation
+- driver: input and video drivers
+- font: fonts
+- lib: libraries
+- proto: X protocol headers
+- util: utilities that don't fit anywhere else
+- xserver: the source for the X servers
+
+In addition Xenocara uses the following directories:
+
+- dist: contains the Mesa sources, shared by lib and xserver above
+- distrib: all binary distribution related tools and data
+- etc: mtree(8) data files
+- share: make(1) configuration for xenocara
+
+