From owner-freebsd-ports@freebsd.org  Thu May 25 06:14:54 2017
Return-Path: <owner-freebsd-ports@freebsd.org>
Delivered-To: freebsd-ports@mailman.ysv.freebsd.org
Received: from mx1.freebsd.org (mx1.freebsd.org
 [IPv6:2001:1900:2254:206a::19:1])
 by mailman.ysv.freebsd.org (Postfix) with ESMTP id 0B6AED81B66
 for <freebsd-ports@mailman.ysv.freebsd.org>;
 Thu, 25 May 2017 06:14:54 +0000 (UTC) (envelope-from adamw@adamw.org)
Received: from apnoea.adamw.org (apnoea.adamw.org [104.225.5.94])
 (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits))
 (Client CN "apnoea.adamw.org",
 Issuer "Let's Encrypt Authority X3" (verified OK))
 by mx1.freebsd.org (Postfix) with ESMTPS id D80A81E0E
 for <freebsd-ports@freebsd.org>; Thu, 25 May 2017 06:14:53 +0000 (UTC)
 (envelope-from adamw@adamw.org)
Received: by apnoea.adamw.org (OpenSMTPD) with ESMTPSA id 89fe3588
 TLS version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=NO;
 Thu, 25 May 2017 00:14:45 -0600 (MDT)
Content-Type: text/plain; charset=us-ascii
Mime-Version: 1.0 (Mac OS X Mail 10.3 \(3273\))
Subject: Re: Document for OPTIONS syntax in /etc/make.conf, where to find?
From: Adam Weinberger <adamw@adamw.org>
In-Reply-To: <B9.BC.29375.11556295@dnvrco-omsmta02>
Date: Thu, 25 May 2017 00:14:44 -0600
Cc: freebsd-ports@freebsd.org
Content-Transfer-Encoding: quoted-printable
Message-Id: <7A0ECD8D-90BC-4FAA-84B9-C9026E1ECFB7@adamw.org>
References: <B9.BC.29375.11556295@dnvrco-omsmta02>
To: Thomas Mueller <mueller6722@twc.com>
X-Mailer: Apple Mail (2.3273)
X-BeenThere: freebsd-ports@freebsd.org
X-Mailman-Version: 2.1.23
Precedence: list
List-Id: Porting software to FreeBSD <freebsd-ports.freebsd.org>
List-Unsubscribe: <https://lists.freebsd.org/mailman/options/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: <https://lists.freebsd.org/mailman/listinfo/freebsd-ports>,
 <mailto:freebsd-ports-request@freebsd.org?subject=subscribe>
X-List-Received-Date: Thu, 25 May 2017 06:14:54 -0000

> On 24 May, 2017, at 21:52, Thomas Mueller <mueller6722@twc.com> wrote:
>=20
> Where do I find documentation so I get the correct syntax for setting =
ports options in /etc/make.conf ?
>=20
> I tried "man ports", "man make", "man make.conf", and the online =
Porters' Handbook but have been unable to find the needle in the =
haystack.
>=20
> NetBSD pkgsrc and Gentoo (Linux) portage document this much better.
>=20
>=20
> Tom

You'll find some info in the instructions at the top of =
/usr/ports/Mk/bsd.options.mk; there's not a lot of info because it's not =
generally the preferred place to specify options.

To turn something off by default on all ports (which can always be =
overridden by make config),
OPTIONS_UNSET=3D	NLS

To turn something off which overrides make config,
OPTIONS_UNSET_FORCE=3D	NLS

You can set options for individual ports in make.conf too, though it's =
almost always a better idea to run 'make config' or 'poudriere options':
/usr/ports/editors/vim$ make -V OPTIONS_NAME
editors_vim

make.conf:
editors_vim_UNSET=3D	NLS

# Adam


--=20
Adam Weinberger
adamw@adamw.org
https://www.adamw.org