From: Marc Espie <marc.espie.openbsd@gmail.com>
Subject: bsd.port.mk.5 tweak
To: ports@openbsd.org
Cc: tb@openbsd.org
Date: Thu, 15 Aug 2024 11:09:56 +0200

Realized that DWZ is not documented, at all.

Also, mandoc -Wall found some shenannigans in USE_LLD.

Please commit that.

Index: bsd.port.mk.5
===================================================================
RCS file: /build/data/openbsd/cvs/src/share/man/man5/bsd.port.mk.5,v
diff -u -p -r1.644 bsd.port.mk.5
--- bsd.port.mk.5	11 Nov 2023 10:46:37 -0000	1.644
+++ bsd.port.mk.5	15 Aug 2024 09:08:19 -0000
@@ -1843,6 +1843,20 @@ package and
 to perform introspection and obtain
 .Nm Ns 's
 default values for variables without needing to access any specific port.
+.It Ev DWZ
+Command line invocation of
+.Xr dwz 1
+to shrink debug information while building debug packages.
+Defaults to
+.Sq dwz -L 100000000
+Can be set to
+.Sq \&:
+to not run
+.Xr dwz 1
+at all.
+See
+.Sx THE DEBUG_PACKAGES INFRASTRUCTURE
+for details.
 .It Ev ECHO_MSG
 User settings.
 Used to display
@@ -3671,10 +3685,9 @@ bfd's
 .Xr ld 1
 .Pc .
 .Sq ports
-force the use of
+forces the use of
 .Xr ld.lld 1
 from lang/clang module.
-.Pc
 Defaults to the appropriate value for the current architecture
 .Po
 see
@@ -3961,7 +3974,7 @@ target ,
 .Xr build-debug-info 1
 will be invoked to deduce debug packing-lists from the normal packing-lists,
 and some extra makefile rules will be invoked to set aside the debug
-information.
+information, and shrink it by processing it through ${DWZ}.
 .Pp
 Then each normal package will have a "shadow" debug-* package built alongside
 it, with the exact same package signature, except it will also be tied closely