diff --git a/hw/darwin/README.apple b/hw/darwin/README.apple
new file mode 100644
index 000000000..0977ce92f
--- /dev/null
+++ b/hw/darwin/README.apple
@@ -0,0 +1,41 @@
+This repository contains patches to the modular X.org server code to allow
+it to be compiled on Darwin/OS X; this would not have been possible
+without the help of Torrey Lyons and Peter O'Gorman, to whom I am
+grateful for their patches, time and moral support.
+
+The server builds 4 targets:
+
+* XDarwin: this server runs on Darwin systems without Quartz
+  (i.e. non-OS X); it has not been well-tested.
+
+* XDarwinApp: this builds XDarwin.app, which is a full X server using
+  Quartz.  It has loadable module support for AGL and CGL, and well as
+  fullscreen and rootless support.
+
+* Xquartz: this server runs on Quartz-based systems, and is meant to
+  work with X11.app
+
+* x11app: this builds a version of Apple's X11.app using patches by
+  Torrey Lyons; most, but not all, functionality of Apple's original
+  X11.app is present in this release.
+
+Known issues:
+
+* AGL and CGL support for 3D indirect acceleration does not work;
+  indirect.c needs to be rewritten.
+
+* Fullscreen mode does not work; I don't know why.
+
+* The keyboard and mouse do not work at all; they worked in X11R7.1,
+  and I believe that they were broken by the events changes in dix/.
+
+* Some features in X11.app are not yet implemented; these are marked
+  with #ifdef DARWIN_DDX_MISSING in the code.
+
+* The build system code could probably be cleaned up slightly.
+
+* Most testing of this code has occurred under 10.5, but it should
+  also work under 10.4.
+
+Any patches or code contributions would be most welcome and may be
+sent to me at bbyer@apple.com.