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 @@
Using Xfce
- USE_XFCE is used to
- autoconfigure the dependencies for ports which use an Xfce
- based library or application like
- x11-toolkits/libxfce4gui
- and x11-wm/xfce4-panel.
+ When a port needs some Xfce
+ library, or application, add USES=xfce,
+ USE_XFCE is then used to state which
+ Xfce dependencies the port
+ needs.
- These Xfce libraries and applications are
- recognized:
+ These Xfce libraries and
+ applications are recognized:
+ garcon: sysutils/garcon
+
+
+
libexo: x11/libexo
@@ -4143,18 +4148,13 @@
- libutil: x11/libxfce4util
+ libmenu: x11/libxfce4menu
- libmcs: x11/libxfce4mcs
-
-
-
- mcsmanager: sysutils/xfce4-mcs-manager
+ libutil: x11/libxfce4util
@@ -4168,37 +4168,53 @@
- wm: x11-wm/xfce4-wm
-
-
-
- xfdev: dev/xfce4-dev-tools
+ xfconf: x11/xfce4-conf
- These additional parameters are recognized:
+ /usr/ports/Mk/Uses/xfce.mk contains the
+ current list of dependencies.
-
-
- configenv: Use this if the port requires a special
- modified CONFIGURE_ENV to find its
- required libraries.
+
+ USES=xfce Example
- -I${LOCALBASE}/include -L${LOCALBASE}/lib
+ USES= xfce
+USE_XFCE= libmenu
+
- gets added to CPPFLAGS to
- CONFIGURE_ENV.
-
-
+
+ Using own Xfce GTK3 Widgets
- Therefore, if a port has a dependency on
- sysutils/xfce4-mcs-manager
- and requires the special CPPFLAGS in its configure
- environment, the syntax will be:
+ In this example, the ported application uses the
+ GTK3 specifics widgets, x11/libxfce4menu and x11/xfce4-conf.
+
+ USES= xfce:gtk3
+USE_XFCE= libmenu xfconf
+
+
+
+ The framework can find dependencies recursively. It is no
+ longer necessary to specify the entire list. If the port only
+ needs x11-wm/xfce4-panel,
+ use:
+
+ USES= xfce
+USE_XFCE= panel
+
+ There is no need to list the components x11-wm/xfce4-panel needs itself like
+ this:
+
+ USES= xfce
+USE_XFCE= libexo libmenu libutil panel
- USE_XFCE= mcsmanager configenv
+ Note however that, as always, all the dependencies the
+ port needs must be added, as there is no garanties the second
+ level dependencies will not change over time.
+
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 @@
(none), gtk3
- Provide support for Xfce
- related ports. See for
- details.
+
+ Provide support for Xfce
+ related ports. See for
+ details.
+
+ The gtk3 argument specifies that
+ port requires GTK3 features provided by x11/libxfce4menu.
+