From c6a2e9a7ae8a2143564e0deae86b7d76ccb1ee04 Mon Sep 17 00:00:00 2001
From: Piotr Pawel Stefaniak <pstef@FreeBSD.org>
Date: Fri, 17 Jul 2020 06:33:20 +0000
Subject: [PATCH] Promote use of unprivileged users for building ports by
 documenting SU_CMD. Phrasing by Daniel O'Connor.

Reviewed by:	0mp
MFC after:	14 days
Differential Revision:	https://reviews.freebsd.org/D25433
---
 share/man/man7/ports.7 | 10 +++++++++-
 1 file changed, 9 insertions(+), 1 deletion(-)

diff --git a/share/man/man7/ports.7 b/share/man/man7/ports.7
index 3a382f9e07e3..eb65d117bded 100644
--- a/share/man/man7/ports.7
+++ b/share/man/man7/ports.7
@@ -25,7 +25,7 @@
 .\"
 .\" $FreeBSD$
 .\"
-.Dd February 4, 2020
+.Dd July 17, 2020
 .Dt PORTS 7
 .Os
 .Sh NAME
@@ -437,6 +437,14 @@ Where to find/put distfiles, normally
 .Pa distfiles/
 in
 .Va PORTSDIR .
+.It Va SU_CMD
+Command used to elevate privilege to configure and install a port.
+The unprivileged user must have write access to
+.Va WRKDIRPREFIX
+and
+.Va DISTDIR .
+The default is
+.Ql /usr/bin/su root -c
 .It Va PACKAGES
 Used only for the
 .Cm package