From 6c832b323659969cbd27ed378faf800a379a4ee6 Mon Sep 17 00:00:00 2001
From: Pav Lucistnik <pav@FreeBSD.org>
Date: Wed, 14 Mar 2007 16:42:06 +0000
Subject: [PATCH] Add docs on USE_XFCE

PR:		docs/108863
Submitted by:	oliver
---
 .../books/porters-handbook/book.sgml          | 77 ++++++++++++++++++-
 1 file changed, 75 insertions(+), 2 deletions(-)

diff --git a/en_US.ISO8859-1/books/porters-handbook/book.sgml b/en_US.ISO8859-1/books/porters-handbook/book.sgml
index 3e0b25a65f..1fe77b9d14 100644
--- a/en_US.ISO8859-1/books/porters-handbook/book.sgml
+++ b/en_US.ISO8859-1/books/porters-handbook/book.sgml
@@ -3425,8 +3425,10 @@ ALWAYS_KEEP_DISTFILES=  yes
 	    and PEAR modules.  <application>Python</application> is discussed
 	    in <xref linkend="using-python">, while
 	    <application>Ruby</application> in <xref linkend="using-ruby">.
-	    Finally, <xref linkend="using-sdl"> provides variables used for
-	    <application>SDL</application> applications.</para>
+	    <xref linkend="using-sdl"> provides variables used for
+	    <application>SDL</application> applications and finally,
+	    <xref linkend="using-xfce"> contains information on
+	    <application>Xfce</application>.</para>
 
 	</sect2>
 
@@ -7775,6 +7777,77 @@ CFLAGS+=        -DLUA_VERSION_STRING="${VER_STR}"
       </sect2>
     </sect1>
 
+    <sect1 id="using-xfce">
+      <title>Using Xfce</title>
+
+      <para>The <makevar>USE_XFCE</makevar> variable is used to autoconfigure
+	the dependencies for ports which use an Xfce based library or application
+	like
+	<filename role="package">x11-toolkits/libxfce4gui</filename> and
+	<filename role="package">x11-wm/xfce4-panel</filename>.</para>
+
+      <para>The following Xfce libraries and applications are recognized at
+	the moment:</para>
+
+      <itemizedlist>
+	<listitem>
+	  <para>libexo: <filename role="package">x11/libexo</filename></para>
+	</listitem>
+
+	<listitem>
+	  <para>libgui: <filename role="package">x11-toolkits/libxfce4gui</filename></para>
+	</listitem>
+
+	<listitem>
+	  <para>libutil: <filename role="package">x11/libxfce4util</filename></para>
+	</listitem>
+
+	<listitem>
+	  <para>libmcs: <filename role="package">x11/libxfce4mcs</filename></para>
+	</listitem>
+
+	<listitem>
+	  <para>mcsmanager: <filename role="package">sysutils/xfce4-mcs-manager</filename></para>
+	</listitem>
+
+	<listitem>
+	  <para>panel: <filename role="package">x11-wm/xfce4-panel</filename></para>
+	</listitem>
+
+	<listitem>
+	  <para>thunar: <filename role="package">x11-fm/thunar</filename></para>
+	</listitem>
+
+	<listitem>
+	  <para>wm: <filename role="package">x11-wm/xfce4-wm</filename></para>
+	</listitem>
+
+	<listitem>
+	  <para>xfdev: <filename role="package">dev/xfce4-dev-tools</filename></para>
+	</listitem>
+
+      </itemizedlist>
+
+      <para>The following additional parameters are recognized:</para>
+
+      <itemizedlist>
+	<listitem>
+	  <para>configenv: Use this if your port requires a special modified
+	    <makevar>CONFIGURE_ENV</makevar> to find it's required libraries.
+	    <programlisting>-I&dollar;{LOCALBASE}/include -L&dollar;{LOCALBASE}/lib</programlisting>
+	    gets added to CPPFLAGS to <makevar>CONFIGURE_ENV</makevar>.
+	</listitem>
+
+      </itemizedlist>
+
+      <para>Therefore, if a port has a dependency on
+	<filename role="package">sysutils/xfce4-mcs-manager</filename> and
+	requires the special CPPFLAGS in its configure environment,
+	the syntax will be:</para>
+
+      <programlisting>USE_XFCE=        mcsmanager configenv</programlisting>
+    </sect1>
+
     <sect1 id="rc-scripts">
       <title>Starting and stopping services (rc scripts)</title>