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,83 +4122,128 @@ 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. + Ports that need Xfce libraries or + applications set USES=xfce. - These Xfce libraries and applications are - recognized: + Specific Xfce libraries and + applications dependencies are set with values assigned to + USE_XFCE. They are defined in + /usr/ports/Mk/Uses/xfce.mk. The possible + values are: - - - libexo: x11/libexo - + + Values of <varname>USE_XFCE</varname> - - libgui: x11-toolkits/libxfce4gui - + + garcon - - libutil: x11/libxfce4util - + + sysutils/garcon + + - - libmcs: x11/libxfce4mcs - + + libexo - - mcsmanager: sysutils/xfce4-mcs-manager - + + x11/libexo + + - - panel: x11-wm/xfce4-panel - + - - thunar: x11-fm/thunar - + libgui - - wm: x11-wm/xfce4-wm - + + x11-toolkits/libxfce4gui + + - - xfdev: dev/xfce4-dev-tools - - + + libmenu - These additional parameters are recognized: + + x11/libxfce4menu + + - - - configenv: Use this if the port requires a special - modified CONFIGURE_ENV to find its - required libraries. + + libutil - -I${LOCALBASE}/include -L${LOCALBASE}/lib + + x11/libxfce4util + + - gets added to CPPFLAGS to - CONFIGURE_ENV. - - + + panel - 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: + + x11-wm/xfce4-panel + + + + + thunar + + + x11-fm/thunar + + + + + xfconf + + + x11/xfce4-conf + + + + + + <varname>USES=xfce</varname> Example + + USES= xfce +USE_XFCE= libmenu + + + + Using Xfce's Own GTK3 Widgets + + In this example, the ported application uses the + GTK3-specific widgets x11/libxfce4menu and x11/xfce4-conf. + + USES= xfce:gtk3 +USE_XFCE= libmenu xfconf + + + + Xfce 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 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 + However, Xfce components and + non-Xfce dependencies of the port + must be included explicitly. Do not count on an + Xfce component to provide a + sub-dependency other than itself for the main port. + 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,16 @@ (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 + the port requires GTK3 + features provided by x11/libxfce4menu. +