From owner-svn-doc-head@FreeBSD.ORG Wed May 13 07:41:03 2015 Return-Path: Delivered-To: svn-doc-head@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [8.8.178.115]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by hub.freebsd.org (Postfix) with ESMTPS id 0AFD8659; Wed, 13 May 2015 07:41:03 +0000 (UTC) Received: from svn.freebsd.org (svn.freebsd.org [IPv6:2001:1900:2254:2068::e6a:0]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (Client did not present a certificate) by mx1.freebsd.org (Postfix) with ESMTPS id E23F31BFD; Wed, 13 May 2015 07:41:02 +0000 (UTC) Received: from svn.freebsd.org ([127.0.1.70]) by svn.freebsd.org (8.14.9/8.14.9) with ESMTP id t4D7f2SH009420; Wed, 13 May 2015 07:41:02 GMT (envelope-from mat@FreeBSD.org) Received: (from mat@localhost) by svn.freebsd.org (8.14.9/8.14.9/Submit) id t4D7f2Ng009417; Wed, 13 May 2015 07:41:02 GMT (envelope-from mat@FreeBSD.org) Message-Id: <201505130741.t4D7f2Ng009417@svn.freebsd.org> X-Authentication-Warning: svn.freebsd.org: mat set sender to mat@FreeBSD.org using -f From: Mathieu Arnold Date: Wed, 13 May 2015 07:41:02 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r46689 - in head/en_US.ISO8859-1/books/porters-handbook: special uses X-SVN-Group: doc-head MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-BeenThere: svn-doc-head@freebsd.org X-Mailman-Version: 2.1.20 Precedence: list List-Id: SVN commit messages for the doc tree for head List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 13 May 2015 07:41:03 -0000 Author: mat Date: Wed May 13 07:41:01 2015 New Revision: 46689 URL: https://svnweb.freebsd.org/changeset/doc/46689 Log: Update XFCE section. PR: 197878 (based on) Differential Revision: https://reviews.freebsd.org/D2439 Submitted by: olivierd Reviewed by: wblock, gjb Approved by: wblock (mentor) Sponsored by: Absolight Modified: head/en_US.ISO8859-1/books/porters-handbook/special/chapter.xml head/en_US.ISO8859-1/books/porters-handbook/uses/chapter.xml Modified: head/en_US.ISO8859-1/books/porters-handbook/special/chapter.xml ============================================================================== --- head/en_US.ISO8859-1/books/porters-handbook/special/chapter.xml Wed May 13 03:55:46 2015 (r46688) +++ head/en_US.ISO8859-1/books/porters-handbook/special/chapter.xml Wed May 13 07:41:01 2015 (r46689) @@ -4122,83 +4122,128 @@ post-patch: 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. - - These Xfce libraries and applications are - recognized: - - - - libexo: x11/libexo - - - - libgui: x11-toolkits/libxfce4gui - - - - libutil: x11/libxfce4util - - - - libmcs: x11/libxfce4mcs - - - - mcsmanager: sysutils/xfce4-mcs-manager - - - - panel: x11-wm/xfce4-panel - - - - thunar: x11-fm/thunar - - - - wm: x11-wm/xfce4-wm - - - - xfdev: dev/xfce4-dev-tools - - - - These additional parameters are recognized: - - - - configenv: Use this if the port requires a special - modified CONFIGURE_ENV to find its - required libraries. - - -I${LOCALBASE}/include -L${LOCALBASE}/lib - - gets added to CPPFLAGS to - CONFIGURE_ENV. - - - - 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: + Ports that need Xfce libraries or + applications set USES=xfce. - USE_XFCE= mcsmanager configenv + Specific Xfce library and + application dependencies are set with values assigned to + USE_XFCE. They are defined in + /usr/ports/Mk/Uses/xfce.mk. The possible + values are: + + + Values of <varname>USE_XFCE</varname> + + + garcon + + + sysutils/garcon + + + + + libexo + + + x11/libexo + + + + + + libgui + + + x11-toolkits/libxfce4gui + + + + + libmenu + + + x11/libxfce4menu + + + + + libutil + + + x11/libxfce4util + + + + + panel + + + 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 + + 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. + Modified: head/en_US.ISO8859-1/books/porters-handbook/uses/chapter.xml ============================================================================== --- head/en_US.ISO8859-1/books/porters-handbook/uses/chapter.xml Wed May 13 03:55:46 2015 (r46688) +++ head/en_US.ISO8859-1/books/porters-handbook/uses/chapter.xml Wed May 13 07:41:01 2015 (r46689) @@ -1378,9 +1378,16 @@ GSSAPI_NONE_CONFIGURE_ON= --without-gssa (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. +