svn commit: r367708 - stable/11/share/man/man7

[Mateusz Piotrowski]

Author: 0mp (doc,ports committer)
Date: Sun Nov 15 12:31:07 2020
New Revision: 367708
URL: https://svnweb.freebsd.org/changeset/base/367708

Log:
  MFC r367253:
  
  Document how to use sudo for SU_CMD
  
  It is rather common for the ports users to replace su(1) with sudo(8)
  within the SU_CMD variable. Let's document it in the manual page (so far
  it's been hidden in a comment within bsd.commands.mk).

Modified:
  stable/11/share/man/man7/ports.7
Directory Properties:
  stable/11/   (props changed)

Modified: stable/11/share/man/man7/ports.7
==============================================================================
--- stable/11/share/man/man7/ports.7	Sun Nov 15 12:28:57 2020	(r367707)
+++ stable/11/share/man/man7/ports.7	Sun Nov 15 12:31:07 2020	(r367708)
@@ -25,7 +25,7 @@
 .\"
 .\" $FreeBSD$
 .\"
-.Dd June 6, 2014
+.Dd November 1, 2020
 .Dt PORTS 7
 .Os
 .Sh NAME
@@ -372,6 +372,17 @@ 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 .
+Many users set it to
+.Ql /usr/local/bin/sudo -E sh -c
+for convenience.
 .It Va PACKAGES
 Used only for the
 .Cm package