wip

1 files changed, 63 insertions, 0 deletions

diff --git a/xlibs/README.md b/xlibs/README.md
new file mode 100644
index 000000000..58e33bcd5
--- /dev/null
+++ b/xlibs/README.md
@@ -0,0 +1,63 @@
+# Bundled X11 Headers
+
+This directory contains bundled X11 headers for building FLTK without
+system X11 development packages installed.
+
+## Required Sources
+
+Download from freedesktop.org:
+
+1. **xorgproto** - X11 protocol headers
+   https://gitlab.freedesktop.org/xorg/proto/xorgproto
+
+2. **libX11** - Core X11 library headers
+   https://gitlab.freedesktop.org/xorg/lib/libx11
+
+3. **libXext** - X11 extension headers
+   https://gitlab.freedesktop.org/xorg/lib/libxext
+
+4. **libXrender** - Render extension
+   https://gitlab.freedesktop.org/xorg/lib/libxrender
+
+5. **libXinerama** - Xinerama extension
+   https://gitlab.freedesktop.org/xorg/lib/libxinerama
+
+6. **libXfixes** - Xfixes extension
+   https://gitlab.freedesktop.org/xorg/lib/libxfixes
+
+7. **libXcursor** - Cursor library
+   https://gitlab.freedesktop.org/xorg/lib/libxcursor
+
+## Directory Structure
+
+```
+xlibs/
+  include/
+    X11/
+      Xlib.h
+      X.h
+      Xutil.h
+      Xatom.h
+      ...
+      extensions/
+        Xinerama.h
+        Xfixes.h
+        Xrender.h
+      Xcursor/
+        Xcursor.h
+      Xft/
+        Xft.h (system dependency - requires fontconfig/freetype)
+```
+
+## Note on Xft
+
+Xft is NOT bundled because it depends on:
+- FreeType2
+- FontConfig
+- Cairo (optional)
+
+These remain as system dependencies.
+
+## Build Usage
+
+Add `-I./xlibs/include` to CXXFLAGS when X11 dev headers are not installed.