Document how to set ports options via make.conf(5)

This patch is based on:
- https://lists.freebsd.org/pipermail/freebsd-ports-announce/2013-June/000062.html
- current content of /usr/ports/Mk/bsd.options.mk

PR:		194306
Reported by:	Daan K. <daanknip__hotmail_com>
MFC after:	2 weeks
This commit is contained in:
Mateusz Piotrowski 2020-11-03 13:26:00 +00:00
parent 08867050c9
commit fcdfe01616
Notes: svn2git 2020-12-20 02:59:44 +00:00
svn path=/head/; revision=367295

View File

@ -25,7 +25,7 @@
.\"
.\" $FreeBSD$
.\"
.Dd November 1, 2020
.Dd November 3, 2020
.Dt PORTS 7
.Os
.Sh NAME
@ -615,6 +615,25 @@ is going to be built with Python 3.7 support.)
.Li # Ic cd /usr/ports/devel/py-pip
.Li # Ic env FLAVOR=py37 make build
.Ed
.It Sy Example 4\&: No Setting Ports Options via Xr make.conf 5
.Pp
The following lines present various ways of configuring ports options via
.Xr make.conf 5
(as an alternative to, e.g., running
.Dq Li make config ) :
.Bd -literal -offset 2n
# Enable NLS for all ports unless configured otherwise
# using the options dialog.
OPTIONS_SET= NLS
# Disable DOCS for all ports overriding the options set
# via the options dialog.
OPTIONS_UNSET_FORCE= DOCS
# Disable DOCS and EXAMPLES for the shells/zsh port.
shells_zsh_UNSET= DOCS EXAMPLES
.Ed
.Pp
These and other options-related variables are documented in
.Pa /usr/ports/Mk/bsd.options.mk .
.El
.Sh SEE ALSO
.Xr make 1 ,