sync code with last improvements from OpenBSD

share/man/man5/bsd.port.mk.5

@@ -1,4 +1,4 @@
-.\" $OpenBSD: bsd.port.mk.5,v 1.631 2023/09/19 20:50:40 tb Exp $
+.\" $OpenBSD: bsd.port.mk.5,v 1.636 2023/09/27 12:24:22 espie Exp $
 .\"
 .\" Copyright (c) 2000-2008 Marc Espie
 .\"
@@ -24,7 +24,7 @@
 .\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
 .\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 .\"
-.Dd $Mdocdate: September 19 2023 $
+.Dd $Mdocdate: September 27 2023 $
 .Dt BSD.PORT.MK 5
 .Os
 .Sh NAME
@@ -102,9 +102,9 @@ for
 .Xr tsort 1 .
 .Pp
 Note that it is possible to obtain reverse dependency information by
-using
+using the
 .Nm show-reverse-deps
-from the
+script from the
 .Pa sqlports
 package.
 .It Cm full-{build,run,all,test}-depends
@@ -336,18 +336,7 @@ using ${FETCH_CMD}.
 Files are normally retrieved from the list of sites in
 .Ev SITES* .
 .Pp
-Appending
-.Sq :0
-to
-.Sq :9
-to an entry will let
-${FETCH_CMD} retrieve from
-.Ev SITES0
-to
-.Ev SITES9
-instead (deprecated).
-.Pp
-Preferably, adding a suffix to
+Adding a suffix to
 .Ev DISTFILES ,
 .Ev PATCHFILES ,
 .Ev SUPDISTFILES
@@ -1639,6 +1628,12 @@ below for details.
 .It Ev DEBUGINFO_ARCHS
 List of archs for which debug information may be provided as extra packages.
 Normally only amd64 for performance reasons.
+.It Ev DESCR
+Location of description file for the package, defaults to
+.Pa ${PKGDIR}/DESCR
+(or
+.Pa ${PKGDIR}/DESCR${SUBPACKAGE}
+for multi-packages).
 .It Ev DESTDIR
 See
 .Ev DESTDIRNAME .
@@ -2293,7 +2288,9 @@ Seldom used, as it is only needed to link binary data without using the
 compiler.
 .It Ev LLVM_ARCHS
 Set to the list of architectures where LLVM/Clang could be used,
-e.g., via lang/clang port module, see
+e.g., via
+.Sq lang/clang
+port module, see
 .Xr port-modules 5 .
 Read-only.
 Use with
@@ -2717,8 +2714,6 @@ see also
 Special arguments to pass to
 .Xr pkg_create 1 ,
 in addition to the default ones.
-For mips64 and pic libraries, see
-.Sx THE GENERATION OF PACKAGE INFORMATION .
 .It Ev PKG_CREATE
 User settings.
 Path to
@@ -2938,6 +2933,13 @@ Used in
 file names and actual contents, can be overridden for ports
 with branches, like php, e.g.,
 .Li PKGSTEM-main = php-5.6
+.It Ev PLIST
+Location of package packing-list.
+Defaults to
+.Pa ${PKGDIR}/PLIST ,
+or to
+.Pa ${PKGDIR}/PLIST${SUBPACKAGE}
+for multi-packages.
 .It Ev PLIST_DB
 Deprecated, see
 .Ev PLIST_REPOSITORY .
@@ -3242,9 +3244,6 @@ for details.
 Suffix should start with
 .Sq \&.
 and be all lowercase for consistency.
-.It Ev SITES0 , ... , SITES9
-Supplementary locations from which distribution files and patchfiles are
-retrieved (deprecated).
 .It Ev SKIPDIR
 See
 .Xr ports 7 .
@@ -3583,9 +3582,10 @@ instead just set
 .Li BUILD_DEPENDS = devel/libtool .
 .It Ev USE_LLD
 Set to
-.Sq Yes
-or
+.Sq Yes ,
 .Sq \&No
+or
+.Sq ports
 to force the use of
 .Xr ld.lld 1
 .Po
@@ -3593,6 +3593,11 @@ as opposed to
 bfd's
 .Xr ld 1
 .Pc .
+.Sq ports
+force the use of
+.Xr ld.lld 1
+from lang/clang module.
+.Pc
 Defaults to the appropriate value for the current architecture
 .Po
 see
@@ -4223,21 +4228,6 @@ or
 to
 .Ev PKG_ARGS .
 .Pp
-If libraries are built using
-.Pa bsd.lib.mk ,
-special care should be taken for mips64* architectures,
-which do not ever build
-.Pa *pic.a
-files (all mips code is pic already).
-.Nm
-automatically adds
-.Li "-Dno_mips64=1"
-or
-.Li "-Dno_mips64=0"
-to
-.Ev PKG_ARGS ,
-and the porter only needs to provide the appropriate fragment.
-.Pp
 .Xr pkg_add 1
 now calls
 .Xr ldconfig 8
@@ -4341,6 +4331,13 @@ Old location for scripts related to the current port.
 There is no reason for the semantic distinction, use
 .Ev FILESDIR
 for those.
+.It Ev SITES0 , ... , SITES9
+Supplementary locations from which distribution files and patchfiles were
+retrieved, superseded by the more generic
+.Ev SITES.sufx
+matching
+.Ev DISTFILES.sufx
+construct.
 .It Ev USE_BZIP2
 The framework will automatically detect the presence of
 .Pa .tar.bz2