From 764911c9992a0a3ca251d67ae46d1cadf2c7dd47 Mon Sep 17 00:00:00 2001
From: Pav Lucistnik <pav@FreeBSD.org>
Date: Tue, 27 Dec 2005 23:28:10 +0000
Subject: [PATCH] - Document the bento/pointyhat Xvfb hack

---
 .../books/porters-handbook/book.sgml            | 17 +++++++++++++++++
 1 file changed, 17 insertions(+)

diff --git a/en_US.ISO8859-1/books/porters-handbook/book.sgml b/en_US.ISO8859-1/books/porters-handbook/book.sgml
index c6314888b5..341ff4b695 100644
--- a/en_US.ISO8859-1/books/porters-handbook/book.sgml
+++ b/en_US.ISO8859-1/books/porters-handbook/book.sgml
@@ -4810,6 +4810,23 @@ USE_XLIB=      yes</programlisting>
 
       </sect2>
 
+      <sect2>
+	<title>Getting fake <envar>DISPLAY</envar> using Xvfb</title>
+
+	<para>Some applications require a working X11 display for compilation to
+	  succeed.  This pose a problem for the FreeBSD package building
+	  cluster, which operates headless.  When the following canonical hack
+	  is used, the package cluster will start the virtual framebuffer
+	  X server.  The working <envar>DISPLAY</envar> is then passed
+	  to the build.</para>
+
+	<programlisting>.if defined(PACKAGE_BUILDING)
+BUILD_DEPENDS+= Xvfb:${X_VFBSERVER_PORT} \
+                ${X11BASE}/lib/X11/fonts/misc/8x13O.pcf.gz:${X_FONTS_MISC_PORT}
+.endif</programlisting>
+
+      </sect2>
+
     </sect1>
 
     <sect1 id="using-gnome">