svn commit: r46689 - in head/en_US.ISO8859-1/books/porters-handbook: special uses

Mathieu Arnold <[email protected]>
Newsgroups gmane.os.freebsd.devel.cvs.doc
Message-ID <[email protected]> 
Author: mat
Date: Wed May 13 07:41:01 2015
New Revision: 46689
URL: https://svnweb.freebsd.org/changeset/doc/46689

Log:
  Update XFCE section.
  
  PR:		197878 (based on)
  Differential Revision:	https://reviews.freebsd.org/D2439
  Submitted by:	olivierd
  Reviewed by:	wblock, gjb
  Approved by:	wblock (mentor)
  Sponsored by:	Absolight

Modified:
  head/en_US.ISO8859-1/books/porters-handbook/special/chapter.xml
  head/en_US.ISO8859-1/books/porters-handbook/uses/chapter.xml

Modified: head/en_US.ISO8859-1/books/porters-handbook/special/chapter.xml
==============================================================================
--- head/en_US.ISO8859-1/books/porters-handbook/special/chapter.xml	Wed May 13 03:55:46 2015	(r46688)
+++ head/en_US.ISO8859-1/books/porters-handbook/special/chapter.xml	Wed May 13 07:41:01 2015	(r46689)
@@ -4122,83 +4122,128 @@ post-patch:
   <sect1 xml:id="using-xfce">
     <title>Using Xfce</title>
 
-    <para><varname>USE_XFCE</varname> is used to
-      autoconfigure the dependencies for ports which use an Xfce
-      based library or application like
-      <package role="port">x11-toolkits/libxfce4gui</package>
-      and <package role="port">x11-wm/xfce4-panel</package>.</para>
-
-    <para>These Xfce libraries and applications are
-      recognized:</para>
-
-    <itemizedlist>
-      <listitem>
-	<para>libexo: <package
-	    role="port">x11/libexo</package></para>
-      </listitem>
-
-      <listitem>
-	<para>libgui: <package
-	    role="port">x11-toolkits/libxfce4gui</package></para>
-      </listitem>
-
-      <listitem>
-	<para>libutil: <package
-	    role="port">x11/libxfce4util</package></para>
-      </listitem>
-
-      <listitem>
-	<para>libmcs: <package
-	    role="port">x11/libxfce4mcs</package></para>
-      </listitem>
-
-      <listitem>
-	<para>mcsmanager: <package
-	    role="port">sysutils/xfce4-mcs-manager</package></para>
-      </listitem>
-
-      <listitem>
-	<para>panel: <package
-	    role="port">x11-wm/xfce4-panel</package></para>
-      </listitem>
-
-      <listitem>
-	<para>thunar: <package
-	    role="port">x11-fm/thunar</package></para>
-      </listitem>
-
-      <listitem>
-	<para>wm: <package
-	    role="port">x11-wm/xfce4-wm</package></para>
-      </listitem>
-
-      <listitem>
-	<para>xfdev: <package
-	    role="port">dev/xfce4-dev-tools</package></para>
-      </listitem>
-    </itemizedlist>
-
-    <para>These additional parameters are recognized:</para>
-
-    <itemizedlist>
-      <listitem>
-	<para>configenv: Use this if the port requires a special
-	  modified <varname>CONFIGURE_ENV</varname> to find its
-	  required libraries.</para>
-
-	<programlisting>-I&dollar;{LOCALBASE}/include -L&dollar;{LOCALBASE}/lib</programlisting>
-
-	<para>gets added to CPPFLAGS to
-	  <varname>CONFIGURE_ENV</varname>.</para>
-      </listitem>
-    </itemizedlist>
-
-    <para>Therefore, if a port has a dependency on
-      <package role="port">sysutils/xfce4-mcs-manager</package>
-      and requires the special CPPFLAGS in its configure
-      environment, the syntax will be:</para>
+    <para>Ports that need <application>Xfce</application> libraries or
+      applications set <literal>USES=xfce</literal>.</para>
 
-    <programlisting>USE_XFCE=	mcsmanager configenv</programlisting>
+    <para>Specific <application>Xfce</application> library and
+      application dependencies are set with values assigned to
+      <varname>USE_XFCE</varname>.  They are defined in
+      <filename>/usr/ports/Mk/Uses/xfce.mk</filename>.  The possible
+      values are:</para>
+
+    <variablelist>
+      <title>Values of <varname>USE_XFCE</varname></title>
+
+      <varlistentry>
+	<term>garcon</term>
+
+	<listitem>
+	  <para><package role="port">sysutils/garcon</package></para>
+	</listitem>
+      </varlistentry>
+
+      <varlistentry>
+	<term>libexo</term>
+
+	<listitem>
+	  <para><package role="port">x11/libexo</package></para>
+	</listitem>
+      </varlistentry>
+
+      <varlistentry>
+
+	<term>libgui</term>
+
+	<listitem>
+	  <para><package
+	      role="port">x11-toolkits/libxfce4gui</package></para>
+	</listitem>
+      </varlistentry>
+
+      <varlistentry>
+	<term>libmenu</term>
+
+	<listitem>
+	  <para><package role="port">x11/libxfce4menu</package></para>
+	</listitem>
+      </varlistentry>
+
+      <varlistentry>
+	<term>libutil</term>
+
+	<listitem>
+	  <para><package role="port">x11/libxfce4util</package></para>
+	</listitem>
+      </varlistentry>
+
+      <varlistentry>
+	<term>panel</term>
+
+	<listitem>
+	  <para><package
+	      role="port">x11-wm/xfce4-panel</package></para>
+	</listitem>
+      </varlistentry>
+
+      <varlistentry>
+	<term>thunar</term>
+
+	<listitem>
+	  <para><package role="port">x11-fm/thunar</package></para>
+	</listitem>
+      </varlistentry>
+
+      <varlistentry>
+	<term>xfconf</term>
+
+	<listitem>
+	  <para><package role="port">x11/xfce4-conf</package></para>
+	</listitem>
+      </varlistentry>
+    </variablelist>
+
+    <example xml:id="use-xfce">
+      <title><varname>USES=xfce</varname> Example</title>
+
+      <programlisting>USES=		xfce
+USE_XFCE=	libmenu</programlisting>
+    </example>
+
+    <example xml:id="use-xfce-gtk3">
+      <title>Using Xfce's Own GTK3 Widgets</title>
+
+      <para>In this example, the ported application uses the
+	<application>GTK3</application>-specific widgets <package
+	  role="port">x11/libxfce4menu</package> and <package
+	  role="port">x11/xfce4-conf</package>.</para>
+
+      <programlisting>USES=		xfce:gtk3
+USE_XFCE=	libmenu xfconf</programlisting>
+    </example>
+
+    <tip>
+      <para><application>Xfce</application> components included this
+	way will automatically include any dependencies they need.  It
+	is no longer necessary to specify the entire list.  If the
+	port only needs <package
+	  role="port">x11-wm/xfce4-panel</package>, use:</para>
+
+      <programlisting>USES=		xfce
+USE_XFCE=	panel</programlisting>
+
+      <para>There is no need to list the components <package
+	  role="port">x11-wm/xfce4-panel</package> needs itself like
+	this:</para>
+
+      <programlisting>USES=		xfce
+USE_XFCE=	libexo libmenu libutil panel</programlisting>
+
+      <para>However, <application>Xfce</application> components and
+	non-<application>Xfce</application> dependencies of the port
+	must be included explicitly.  Do not count on an
+	<application>Xfce</application> component to provide a
+	sub-dependency other than itself for the main port.</para>
+    </tip>
   </sect1>
 
   <sect1 xml:id="using-mozilla">

Modified: head/en_US.ISO8859-1/books/porters-handbook/uses/chapter.xml
==============================================================================
--- head/en_US.ISO8859-1/books/porters-handbook/uses/chapter.xml	Wed May 13 03:55:46 2015	(r46688)
+++ head/en_US.ISO8859-1/books/porters-handbook/uses/chapter.xml	Wed May 13 07:41:01 2015	(r46689)
@@ -1378,9 +1378,16 @@ GSSAPI_NONE_CONFIGURE_ON=	--without-gssa
 
 	  <entry>(none), <literal>gtk3</literal></entry>
 
-	  <entry>Provide support for <application>Xfce</application>
-	    related ports.  See <xref linkend="using-xfce"/> for
-	    details.</entry>
+	  <entry>
+	    <para>Provide support for <application>Xfce</application>
+	      related ports.  See <xref linkend="using-xfce"/> for
+	      details.</para>
+
+	    <para>The <literal>gtk3</literal> argument specifies that
+	      the port requires <application>GTK3</application>
+	      features provided by <package
+		role="port">x11/libxfce4menu</package>.</para>
+	  </entry>
 	</row>
 
 	<row xml:id="uses-zip">
_______________________________________________
[email protected] mailing list
http://lists.freebsd.org/mailman/listinfo/svn-doc-all
To unsubscribe, send any mail to "[email protected]"
lmpx.com only provides a reader for public news (NNTP) servers. It is not affiliated with the servers or forums shown here and is not responsible for the content of articles, which is written by their respective authors.