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. + + <varname>USES=xfce</varname> 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. +