svn commit: r367295 - head/share/man/man7

[Mateusz Piotrowski]

Author: 0mp (doc,ports committer)
Date: Tue Nov  3 13:26:00 2020
New Revision: 367295
URL: https://svnweb.freebsd.org/changeset/base/367295

Log:
  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

Modified:
  head/share/man/man7/ports.7

Modified: head/share/man/man7/ports.7
==============================================================================
--- head/share/man/man7/ports.7	Tue Nov  3 12:29:10 2020	(r367294)
+++ head/share/man/man7/ports.7	Tue Nov  3 13:26:00 2020	(r367295)
@@ -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 ,