Attachment 153272 Details for Bug 197878 – Patch to update the Xfce section

[patch] Patch to update the Xfce section

porters-handbook.diff (text/plain), 4.57 KB, created by Olivier Duchateau on 2015-02-21 15:28:51 UTC

(hide)

Description:

Filename:

MIME Type:

Creator: Olivier Duchateau

Created: 2015-02-21 15:28:51 UTC

Size: 4.57 KB

patch

obsolete

>Index: special/chapter.xml
>===================================================================
>--- special/chapter.xml	(révision 46282)
>+++ special/chapter.xml	(copie de travail)
>@@ -4125,14 +4125,19 @@
>     <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>
>-
>+      <package role="port">x11/libxfce4menu</package> and <package
>+      role="port">x11-wm/xfce4-panel</package>.</para>
>+      
>     <para>These Xfce 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,21 +4148,16 @@
>       </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>
>+	<para>libutil: <package
>+	    role="port">x11/libxfce4util</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>
>@@ -4168,37 +4168,44 @@
>       </listitem>
> 
>       <listitem>
>-	<para>wm: <package
>-	    role="port">x11-wm/xfce4-wm</package></para>
>+	<para>xfconf: <package
>+	    role="port">x11/xfce4-conf</package></para>
>       </listitem>
>-
>-      <listitem>
>-	<para>xfdev: <package
>-	    role="port">dev/xfce4-dev-tools</package></para>
>-      </listitem>
>     </itemizedlist>
> 
>-    <para>These additional parameters are recognized:</para>
>+    <para>Always up-to-date list can be found in
>+      <filename>/usr/ports/Mk/Uses/xfce.mk</filename>.</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 GTK3
>+	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>
> 
>-    <programlisting>USE_XFCE=	mcsmanager configenv</programlisting>
>+    <tip>
>+      <para>The new framework can find dependencies recursively. It is no
>+	longer necessary to specify the entire list.</para>
>+
>+      <programlisting>USES=           xfce
>+USE_XFCE=       panel</programlisting>
>+
>+      <para>is equivalent to:</para>
>+
>+      <programlisting>USES=           xfce
>+USE_XFCE=       libexo libmenu libutil panel</programlisting>
>+    </tip>
>   </sect1>
> 
>   <sect1 xml:id="using-mozilla">
>Index: uses/chapter.xml
>===================================================================
>--- uses/chapter.xml	(révision 46282)
>+++ uses/chapter.xml	(copie de travail)
>@@ -1298,6 +1298,22 @@
> 	    </itemizedlist></entry>
> 	</row>
> 
>+	<row xml:id="uses-xfce">
>+	  <entry><literal>xfce</literal></entry>
>+
>+	  <entry>(none), <literal>gtk3</literal></entry>
>+
>+	  <entry>
>+	    <para>Handle dependencies needed by Xfce libraries. For
>+	      more information see <xref
>+	      linkend="using-xfce"/>.</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">
> 	  <entry><literal>zip</literal></entry>
>

Actions: View | Diff

Attachments on bug 197878: 153272