Date: Wed, 13 May 2015 07:41:02 +0000 (UTC) From: Mathieu Arnold <mat@FreeBSD.org> To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r46689 - in head/en_US.ISO8859-1/books/porters-handbook: special uses Message-ID: <201505130741.t4D7f2Ng009417@svn.freebsd.org>
next in thread | raw e-mail | index | archive | help
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${LOCALBASE}/include -L${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">
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?201505130741.t4D7f2Ng009417>