Skip site navigation (1)Skip section navigation (2)
Date:      Sun, 20 May 2012 13:06:57 +0100
From:      Chris Rees <crees@FreeBSD.org>
To:        Warren Block <wblock@wonkity.com>
Cc:        Mark Linimon <linimon@lonesome.com>, Scot Hetzel <swhetzel@gmail.com>, Andriy Gapon <avg@freebsd.org>, freebsd-ports@freebsd.org
Subject:   Re: WITH_GCC
Message-ID:  <CADLo838i1pydvZrzMbq=kJrg%2BHHyGvSp%2Bxr2=piCLMaWaajq2Q@mail.gmail.com>
In-Reply-To: <alpine.BSF.2.00.1205172027340.62885@wonkity.com>
References:  <CAGFTUwPUFdP=Z20%2BbL59qFuh_V6R1R-GcyrK03dxESL6ZyGz7A@mail.gmail.com> <4F578AA7.4060008@FreeBSD.org> <4F990D9A.3090100@FreeBSD.org> <4FA643FA.3050206@FreeBSD.org> <4FAB6E01.50108@FreeBSD.org> <CACdU%2Bf_77t7GCH2hm3hwcK2i%2BTcHUq_aBP4a7SeghQhGz3soDg@mail.gmail.com> <4FAC2EC1.8040708@FreeBSD.org> <20120517014743.GB5348@lonesome.com> <alpine.BSF.2.00.1205172027340.62885@wonkity.com>

next in thread | previous in thread | raw e-mail | index | archive | help
On 20 May 2012 06:18, Warren Block <wblock@wonkity.com> wrote:
> 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/makefi=
le-options.html#AEN2542
>>
>> USE:
>>
>>
>> http://www.freebsd.org/doc/en_US.ISO8859-1/books/porters-handbook/makefi=
le-depend.html#USE-VARS
>>
>> Unfortunately WANT is only documented in bsd.port.mk itself. =A0Does
>> 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=3D1.=
708
>> (line 285)
>
>
> Okay, I'll bite. =A0However, 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. =A0Other than that, it's qui=
te
> clear. =A0Maybe:
>
> WITH_ and WITHOUT_ variables may be set by the port maintainer as default=
s,
> and modified by the end user as configuration options. Example:
>
> =A0WITHOUT_X11=3D =A0yes

This is about to be phased out in favour of optionsng.  I would
seriously consider whether a revision of the docs is worth it until
optionsNG is committed some time fairly soon.

> USE_ variables are set by the port maintainer to define software on which
> this port depends. =A0Example:
>
> =A0USE_BZIP2=3D =A0 =A0yes

Yes.

> WANT_ variables are set by the port maintainer to prefer one version or
> variation of a dependency over another. =A0Examples:
>
> =A0WANT_OPENLDAP_VER=3D =A0 =A023
> =A0WANT_BDB_VER=3D =A0 =A0 =A0 =A0 48
> =A0WANT_PGSQL_VER=3D =A0 =A0 =A0 90
> =A0WANT_PHP_WEB=3D =A0 =A0 =A0 =A0 yes
>

Usually.  Sometimes it's (ab)used to include the relevant bsd.*.mk
file without adding dependencies (WANT_GNOME), but normally that's
what WANT_ is used for.

Definitely add a warning that if you want to use a WANT_ variable you
should also check the relevant Mk/ files to check for syntax.

Chris



Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?CADLo838i1pydvZrzMbq=kJrg%2BHHyGvSp%2Bxr2=piCLMaWaajq2Q>