From owner-freebsd-doc@FreeBSD.ORG Sun Jul 28 21:40:00 2013 Return-Path: Delivered-To: freebsd-doc@smarthost.ysv.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [8.8.178.115]) (using TLSv1 with cipher ADH-AES256-SHA (256/256 bits)) (No client certificate requested) by hub.freebsd.org (Postfix) with ESMTP id A732FB1D for ; Sun, 28 Jul 2013 21:40:00 +0000 (UTC) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:1900:2254:206c::16:87]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by mx1.freebsd.org (Postfix) with ESMTPS id 858F22BE6 for ; Sun, 28 Jul 2013 21:40:00 +0000 (UTC) Received: from freefall.freebsd.org (localhost [127.0.0.1]) by freefall.freebsd.org (8.14.7/8.14.7) with ESMTP id r6SLe0pm081031 for ; Sun, 28 Jul 2013 21:40:00 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.14.7/8.14.7/Submit) id r6SLe0er081030; Sun, 28 Jul 2013 21:40:00 GMT (envelope-from gnats) Resent-Date: Sun, 28 Jul 2013 21:40:00 GMT Resent-Message-Id: <201307282140.r6SLe0er081030@freefall.freebsd.org> Resent-From: FreeBSD-gnats-submit@FreeBSD.org (GNATS Filer) Resent-To: freebsd-doc@FreeBSD.org Resent-Reply-To: FreeBSD-gnats-submit@FreeBSD.org, Jason Helfman Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) (using TLSv1 with cipher ADH-AES256-SHA (256/256 bits)) (No client certificate requested) by hub.freebsd.org (Postfix) with ESMTP id 41D2796D for ; Sun, 28 Jul 2013 21:32:08 +0000 (UTC) (envelope-from jgh@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:1900:2254:206c::16:87]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by mx1.freebsd.org (Postfix) with ESMTPS id 2E0A22B80 for ; Sun, 28 Jul 2013 21:32:08 +0000 (UTC) Received: from freefall.freebsd.org (localhost [127.0.0.1]) by freefall.freebsd.org (8.14.7/8.14.7) with ESMTP id r6SLW7Nu080888 for ; Sun, 28 Jul 2013 21:32:08 GMT (envelope-from jgh@freefall.freebsd.org) Received: (from jgh@localhost) by freefall.freebsd.org (8.14.7/8.14.7/Submit) id r6SLW71i080887; Sun, 28 Jul 2013 21:32:07 GMT (envelope-from jgh) Message-Id: <201307282132.r6SLW71i080887@freefall.freebsd.org> Date: Sun, 28 Jul 2013 21:32:07 GMT From: Jason Helfman To: FreeBSD-gnats-submit@freebsd.org X-Send-Pr-Version: 3.114 Subject: docs/180912: [patch][porters-handbook] document gmake/imake in Uses, trim kde3 X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.14 Precedence: list Reply-To: Jason Helfman List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sun, 28 Jul 2013 21:40:00 -0000 >Number: 180912 >Category: docs >Synopsis: [patch][porters-handbook] document gmake/imake in Uses, trim kde3 >Confidential: no >Severity: non-critical >Priority: low >Responsible: freebsd-doc >State: open >Quarter: >Keywords: >Date-Required: >Class: change-request >Submitter-Id: current-users >Arrival-Date: Sun Jul 28 21:40:00 UTC 2013 >Closed-Date: >Last-Modified: >Originator: Jason Helfman >Release: FreeBSD 10.0-CURRENT amd64 >Organization: >Environment: System: FreeBSD freefall.freebsd.org 10.0-CURRENT FreeBSD 10.0-CURRENT #0 r253323: Sat Jul 13 18:26:21 UTC 2013 peter@freefall.freebsd.org:/usr/obj/usr/src/sys/FREEFALL amd64 >Description: update uses to include gmake and imake and trim kde3 ( no longer in tree ) >How-To-Repeat: >Fix: Index: en_US.ISO8859-1/books/porters-handbook/uses.xml =================================================================== --- en_US.ISO8859-1/books/porters-handbook/uses.xml (revision 42463) +++ en_US.ISO8859-1/books/porters-handbook/uses.xml (working copy) @@ -97,6 +97,14 @@ + gmake + (none) + Implies that the port uses devel/gmake as build-time + dependency. + + + iconv (none) Implies that the port uses + imake + (none) + Implies that the port uses devel/imake as build-time + dependency. + + + ncurses (none), base, port Index: en_US.ISO8859-1/books/porters-handbook/book.xml =================================================================== --- en_US.ISO8859-1/books/porters-handbook/book.xml (revision 42463) +++ en_US.ISO8859-1/books/porters-handbook/book.xml (working copy) @@ -559,7 +559,7 @@ The build target is run. This is responsible for descending into the port's private working directory (WRKSRC) and building - it. If USE_GMAKE is set, GNU + it. If USES= gmake is set, GNU make will be used, otherwise the system make will be used. @@ -3683,7 +3683,7 @@ variables, which are processed by ports/Mk/bsd.*.mk to augment initial build dependencies. For example, - USE_GMAKE=yes adds USES= gmake adds devel/gmake to BUILD_DEPENDS. To prevent such additional dependencies from polluting @@ -5299,7 +5299,7 @@ imake If your port uses GNU make, - set USE_GMAKE=yes. + set USES= gmake. Variables for Ports Related to @@ -5315,7 +5315,7 @@ <tbody> <row> - <entry><makevar>USE_GMAKE</makevar></entry> + <entry><makevar>USES= gmake</makevar></entry> <entry>The port requires <command>gmake</command> to build.</entry> </row> @@ -5333,7 +5333,7 @@ <filename>Makefile</filename> files from <filename>Imakefile</filename> files using <application>imake</application>, then set - <literal>USE_IMAKE=yes</literal>. This will cause the + <literal>USES= imake</literal>. This will cause the configure stage to automatically do an <command>xmkmf -a</command>. If the <option>-a</option> flag is a problem for your port, set <literal>XMKMF=xmkmf</literal>. @@ -6076,7 +6076,7 @@ <tgroup cols="2"> <tbody> <row> - <entry><makevar>USE_IMAKE</makevar></entry> + <entry><makevar>USES= imake</makevar></entry> <entry>The port uses <command>imake</command>.</entry> </row> @@ -6742,36 +6742,6 @@ <sect1 id="using-kde"> <title>Using KDE - - Variable Definitions (KDE 3.x Only) - -
- Variables for Ports That Use KDE 3.x - - - - - USE_KDELIBS_VER - The port uses KDE libraries. It specifies the - major version of KDE to use and implies - USE_QT_VER of the appropriate - version. The only possible value is - 3. - - - - USE_KDEBASE_VER - The port uses KDE base. It specifies the major - version of KDE to use and implies - USE_QT_VER of the appropriate - version. The only possible value is - 3. - - - -
- - KDE 4 Variable Definitions @@ -6935,10 +6905,10 @@ KDE 4.x ports are installed into KDE4_PREFIX, which is - /usr/local/kde4 currently, to avoid - conflicts with KDE 3.x ports. This is achieved by - specifying the kdeprefix component, which - overrides the default PREFIX. The ports + /usr/local/kde4 currently. + This is achieved by specifying the + kdeprefix component, which overrides + the default PREFIX. The ports however respect any PREFIX set via MAKEFLAGS environment variable and/or make arguments. @@ -7270,7 +7240,7 @@ default one will be set that simply runs Ant according to MAKE_ENV, MAKE_ARGS and ALL_TARGET. This is similar to the - USE_GMAKE mechanism, which is documented + USES= gmake mechanism, which is documented in . @@ -16844,9 +16814,9 @@ [If it requires a "configure" script generated by GNU autoconf to be run] GNU_CONFIGURE= yes [If it requires GNU make, not /usr/bin/make, to build...] -USE_GMAKE= yes +USES= gmake [If it is an X application and requires "xmkmf -a" to be run...] -USE_IMAKE= yes +USES= imake [et cetera.] [non-standard variables to be used in the rules below] >Release-Note: >Audit-Trail: >Unformatted: