From owner-freebsd-ports@FreeBSD.ORG  Sun May 20 05:18:51 2012
Return-Path: <owner-freebsd-ports@FreeBSD.ORG>
Delivered-To: freebsd-ports@freebsd.org
Received: from mx1.freebsd.org (mx1.freebsd.org [69.147.83.52])
	by hub.freebsd.org (Postfix) with ESMTP id AF03C106564A;
	Sun, 20 May 2012 05:18:51 +0000 (UTC)
	(envelope-from wblock@wonkity.com)
Received: from wonkity.com (wonkity.com [67.158.26.137])
	by mx1.freebsd.org (Postfix) with ESMTP id 67A4C8FC0C;
	Sun, 20 May 2012 05:18:50 +0000 (UTC)
Received: from wonkity.com (localhost [127.0.0.1])
	by wonkity.com (8.14.5/8.14.5) with ESMTP id q4K5InbX034151;
	Sat, 19 May 2012 23:18:49 -0600 (MDT)
	(envelope-from wblock@wonkity.com)
Received: from localhost (wblock@localhost)
	by wonkity.com (8.14.5/8.14.5/Submit) with ESMTP id q4K5InkB034148;
	Sat, 19 May 2012 23:18:49 -0600 (MDT)
	(envelope-from wblock@wonkity.com)
Date: Sat, 19 May 2012 23:18:49 -0600 (MDT)
From: Warren Block <wblock@wonkity.com>
To: Mark Linimon <linimon@lonesome.com>
In-Reply-To: <20120517014743.GB5348@lonesome.com>
Message-ID: <alpine.BSF.2.00.1205172027340.62885@wonkity.com>
References: <CAGFTUwPUFdP=Z20+bL59qFuh_V6R1R-GcyrK03dxESL6ZyGz7A@mail.gmail.com>
	<4F578AA7.4060008@FreeBSD.org> <4F990D9A.3090100@FreeBSD.org>
	<4FA643FA.3050206@FreeBSD.org> <4FAB6E01.50108@FreeBSD.org>
	<CACdU+f_77t7GCH2hm3hwcK2i+TcHUq_aBP4a7SeghQhGz3soDg@mail.gmail.com>
	<4FAC2EC1.8040708@FreeBSD.org> <20120517014743.GB5348@lonesome.com>
User-Agent: Alpine 2.00 (BSF 1167 2008-08-23)
MIME-Version: 1.0
Content-Type: TEXT/PLAIN; format=flowed; charset=US-ASCII
X-Greylist: Sender IP whitelisted, not delayed by milter-greylist-4.2.7
	(wonkity.com [127.0.0.1]); Sat, 19 May 2012 23:18:49 -0600 (MDT)
Cc: Scot Hetzel <swhetzel@gmail.com>, freebsd-ports@freebsd.org,
	Andriy Gapon <avg@freebsd.org>
Subject: Re: WITH_GCC
X-BeenThere: freebsd-ports@freebsd.org
X-Mailman-Version: 2.1.5
Precedence: list
List-Id: Porting software to FreeBSD <freebsd-ports.freebsd.org>
List-Unsubscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-ports>,
	<mailto:freebsd-ports-request@freebsd.org?subject=unsubscribe>
List-Archive: <http://lists.freebsd.org/pipermail/freebsd-ports>
List-Post: <mailto:freebsd-ports@freebsd.org>
List-Help: <mailto:freebsd-ports-request@freebsd.org?subject=help>
List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-ports>,
	<mailto:freebsd-ports-request@freebsd.org?subject=subscribe>
X-List-Received-Date: Sun, 20 May 2012 05:18:51 -0000

On Wed, 16 May 2012, Mark Linimon wrote:

> On Fri, May 11, 2012 at 12:10:25AM +0300, Andriy Gapon wrote:
>> P.S.
>> Perhaps this information should also be somewhere in the Porter's Handbook.
>
> It is scattered around in it:
>
> WITH/WITHOUT:
>
> http://www.freebsd.org/doc/en_US.ISO8859-1/books/porters-handbook/makefile-options.html#AEN2542
>
> USE:
>
> http://www.freebsd.org/doc/en_US.ISO8859-1/books/porters-handbook/makefile-depend.html#USE-VARS
>
> Unfortunately WANT is only documented in bsd.port.mk itself.  Does
> anyone wish to take on the task of adding a tips-and-tricks entry
> about the difference between the 3 to the PH?
>
> http://www.freebsd.org/cgi/cvsweb.cgi/ports/Mk/bsd.port.mk?annotate=1.708
> (line 285)

Okay, I'll bite.  However, I missed the earlier part of the thread and 
the descriptions of the USE and WANT options weren't very clear to me. 
Also I'm not sure where the text should go in the PH.  Other than that, 
it's quite clear.  Maybe:

WITH_ and WITHOUT_ variables may be set by the port maintainer as 
defaults, and modified by the end user as configuration options. 
Example:

   WITHOUT_X11=	yes

USE_ variables are set by the port maintainer to define software on 
which this port depends.  Example:

   USE_BZIP2=	yes

WANT_ variables are set by the port maintainer to prefer one version or 
variation of a dependency over another.  Examples:

   WANT_OPENLDAP_VER=	23
   WANT_BDB_VER=		48
   WANT_PGSQL_VER=	90
   WANT_PHP_WEB=		yes