From owner-freebsd-doc@FreeBSD.ORG Fri Apr 26 04:20:00 2013 Return-Path: Delivered-To: freebsd-doc@smarthost.ysv.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) by hub.freebsd.org (Postfix) with ESMTP id AF379CB1 for ; Fri, 26 Apr 2013 04:20:00 +0000 (UTC) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:1900:2254:206c::16:87]) by mx1.freebsd.org (Postfix) with ESMTP id 92DA61BAC for ; Fri, 26 Apr 2013 04:20:00 +0000 (UTC) Received: from freefall.freebsd.org (localhost [127.0.0.1]) by freefall.freebsd.org (8.14.6/8.14.6) with ESMTP id r3Q4K0sF084290 for ; Fri, 26 Apr 2013 04:20:00 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.14.6/8.14.6/Submit) id r3Q4K0lG084289; Fri, 26 Apr 2013 04:20:00 GMT (envelope-from gnats) Resent-Date: Fri, 26 Apr 2013 04:20:00 GMT Resent-Message-Id: <201304260420.r3Q4K0lG084289@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 [8.8.178.115]) by hub.freebsd.org (Postfix) with ESMTP id CC8FFC52; Fri, 26 Apr 2013 04:13:15 +0000 (UTC) (envelope-from jgh@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:1900:2254:206c::16:87]) by mx1.freebsd.org (Postfix) with ESMTP id 804DA1B86; Fri, 26 Apr 2013 04:13:15 +0000 (UTC) Received: from freefall.freebsd.org (localhost [127.0.0.1]) by freefall.freebsd.org (8.14.6/8.14.6) with ESMTP id r3Q4DFhX083846; Fri, 26 Apr 2013 04:13:15 GMT (envelope-from jgh@freefall.freebsd.org) Received: (from jgh@localhost) by freefall.freebsd.org (8.14.6/8.14.6/Submit) id r3Q4DFoS083842; Fri, 26 Apr 2013 04:13:15 GMT (envelope-from jgh) Message-Id: <201304260413.r3Q4DFoS083842@freefall.freebsd.org> Date: Fri, 26 Apr 2013 04:13:15 GMT From: Jason Helfman To: FreeBSD-gnats-submit@freebsd.org X-Send-Pr-Version: 3.114 Subject: docs/178169: [patch][porters-handbook] update documentation for using gettext Cc: bapt@FreeBSD.org, ak@FreeBSD.org 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: Fri, 26 Apr 2013 04:20:00 -0000 >Number: 178169 >Category: docs >Synopsis: [patch][porters-handbook] update documentation for using gettext >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: Fri Apr 26 04:20: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 r249172: Sat Apr 6 00:40:01 UTC 2013 peter@freefall.freebsd.org:/usr/obj/usr/src/sys/FREEFALL amd64 >Description: USE_GETTEXT is now under the USES framework >How-To-Repeat: >Fix: Index: porters-handbook/book.xml =================================================================== --- porters-handbook/book.xml (revision 41499) +++ porters-handbook/book.xml (working copy) @@ -5781,17 +5781,12 @@ Basic Usage - If your port requires gettext, - just set USE_GETTEXT to - yes, and your port will grow the - dependency on devel/gettext. The value of - USE_GETTEXT can also specify the required - version of the libintl library, the basic - part of gettext, but using this feature - is strongly discouraged: Your port - should work with just the current version of devel/gettext. + If your port requires gettext, just + set USES= gettext, and your + port will inherit a dependency on devel/gettext. Other values for + gettext usage can be in . A rather common case is a port using gettext and configure. @@ -5802,7 +5797,7 @@ CPPFLAGS and LDFLAGS as follows: - USE_GETTEXT= yes + USES= gettext CPPFLAGS+= -I${LOCALBASE}/include LDFLAGS+= -L${LOCALBASE}/lib @@ -5811,7 +5806,7 @@ Of course, the code can be more compact if there are no more flags to pass to configure: - USE_GETTEXT= yes + USES= gettext GNU_CONFIGURE= yes @@ -5832,7 +5827,7 @@ .include <bsd.port.options.mk> .if ${PORT_OPTIONS:MNLS} -USE_GETTEXT= yes +USES+= gettext PLIST_SUB+= NLS="" .else CONFIGURE_ARGS+= --disable-nls Index: porters-handbook/uses.xml =================================================================== --- porters-handbook/uses.xml (revision 41499) +++ porters-handbook/uses.xml (working copy) @@ -63,6 +63,19 @@ + gettext + none, lib, build, + run + Implies that the port uses devel/gettext in one way or another. By + default, with no arguments or with the lib + argument, implies gettext with build-time and + run-time dependencies, build implies a build-time + dependency, and run implies a run-time + dependency. + + + pathfix none Look for the Makefile.in and >Release-Note: >Audit-Trail: >Unformatted: