explain about the case where DEBUG_PACKAGES must be set manually

1 files changed, 15 insertions, 2 deletions

diff --git a/share/man/man5/bsd.port.mk.5 b/share/man/man5/bsd.port.mk.5
index a34ece929e9..1422884ef1c 100644
--- a/share/man/man5/bsd.port.mk.5
+++ b/share/man/man5/bsd.port.mk.5
@@ -1,4 +1,4 @@
-.\" $OpenBSD: bsd.port.mk.5,v 1.522 2019/12/08 14:07:08 jmc Exp $
+.\" $OpenBSD: bsd.port.mk.5,v 1.523 2019/12/13 10:23:37 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: December 8 2019 $
+.Dd $Mdocdate: December 13 2019 $
 .Dt BSD.PORT.MK 5
 .Os
 .Sh NAME
@@ -3512,6 +3512,9 @@ so the
 script excepts debug information on all binaries and libraries.
 Most probably, the build machinery for that specific port omitted -g
 somewhere, or it runs strips during fake anyway.
+It can also occur if
+.Ev DEBUG_PACKAGES
+includes subpackages with no files holding debug info.
 .It "Warning: symlink(s) point to non existent file."
 Warning message comes from
 .Xr pkg_create 1 .
@@ -3730,6 +3733,16 @@ and
 .Cm @static-lib
 annotations in the base packing-lists.
 .Pp
+Debug packages will be produced for all subpackages in
+.Ev DEBUG_PACKAGES .
+Usually, the heuristics of trimming arch-independent packages
+from
+.Ev BUILD_PACKAGES
+is enough.
+In case this still produces empty debug packages, the
+.Ev DEBUG_PACKAGES
+list should be produced manually.
+.Pp
 The actual debug packages are not registered through
 .Xr register-plist 1
 since the information was automatically generated.