Page MenuHomeFreeBSD
Files F149376720

D2439.id5176.diff
No OneTemporary
Actions

D2439.id5176.diff
View Options

Index: en_US.ISO8859-1/books/porters-handbook/special/chapter.xml
===================================================================
--- en_US.ISO8859-1/books/porters-handbook/special/chapter.xml
+++ en_US.ISO8859-1/books/porters-handbook/special/chapter.xml
@@ -4122,17 +4122,22 @@
<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>When a port needs some <application>Xfce</application>
+ library, or application, add <literal>USES=xfce</literal>,
+ <varname>USE_XFCE</varname> is then used to state which
+ <application>Xfce</application> dependencies the port
+ needs.</para>
- <para>These Xfce libraries and applications are
- recognized:</para>
+ <para>These <application>Xfce</application> libraries and
+ applications are recognized:</para>
<itemizedlist>
<listitem>
+ <para>garcon: <package
+ role="port">sysutils/garcon</package></para>
+ </listitem>
+
+ <listitem>
<para>libexo: <package
role="port">x11/libexo</package></para>
</listitem>
@@ -4143,18 +4148,13 @@
</listitem>
<listitem>
- <para>libutil: <package
- role="port">x11/libxfce4util</package></para>
+ <para>libmenu: <package
+ role="port">x11/libxfce4menu</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>
+ <para>libutil: <package
+ role="port">x11/libxfce4util</package></para>
</listitem>
<listitem>
@@ -4168,37 +4168,53 @@
</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>
+ <para>xfconf: <package
+ role="port">x11/xfce4-conf</package></para>
</listitem>
</itemizedlist>
- <para>These additional parameters are recognized:</para>
+ <para><filename>/usr/ports/Mk/Uses/xfce.mk</filename> contains the
+ current list of dependencies.</para>
- <itemizedlist>
- <listitem>
- <para>configenv: Use this if the port requires a special
- modified <varname>CONFIGURE_ENV</varname> to find its
- required libraries.</para>
+ <example xml:id="use-xfce">
+ <title><varname>USES=xfce</varname> Example</title>
- <programlisting>-I&dollar;{LOCALBASE}/include -L&dollar;{LOCALBASE}/lib</programlisting>
+ <programlisting>USES= xfce
+USE_XFCE= libmenu</programlisting>
+ </example>
- <para>gets added to CPPFLAGS to
- <varname>CONFIGURE_ENV</varname>.</para>
- </listitem>
- </itemizedlist>
+ <example xml:id="use-xfce-gtk3">
+ <title>Using own Xfce GTK3 Widgets</title>
- <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>In this example, the ported application uses the
+ <application>GTK3</application> specifics 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>The framework can find dependencies recursively. 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>
- <programlisting>USE_XFCE= mcsmanager configenv</programlisting>
+ <para>Note however that, as always, all the dependencies the
+ port needs must be added, as there is no guarantees the second
+ level dependencies will not change over time.</para>
+ </tip>
</sect1>
<sect1 xml:id="using-mozilla">
Index: en_US.ISO8859-1/books/porters-handbook/uses/chapter.xml
===================================================================
--- en_US.ISO8859-1/books/porters-handbook/uses/chapter.xml
+++ en_US.ISO8859-1/books/porters-handbook/uses/chapter.xml
@@ -1378,9 +1378,15 @@
<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
+ port requires GTK3 features provided by <package
+ role="port">x11/libxfce4menu</package>.</para>
+ </entry>
</row>
<row xml:id="uses-zip">

File Metadata

Mime Type
text/plain
Expires
Wed, Mar 25, 1:41 AM (6 m, 35 s)
Storage Engine
blob
Storage Format
Raw Data
Storage Handle
30288459
Default Alt Text
D2439.id5176.diff (5 KB)

Event Timeline