From 1ccb9c39e3dfde78b8572567196f2aca6cd6cf97 Mon Sep 17 00:00:00 2001
From: espie <espie@openbsd.org>
Date: Tue, 12 Nov 2019 16:37:48 +0000
Subject: document the new annotations corresponding to DEBUG_PACKAGES

---
 usr.sbin/pkg_add/pkg_create.1 | 26 +++++++++++++++++++++++---
 1 file changed, 23 insertions(+), 3 deletions(-)

(limited to 'usr.sbin/pkg_add')

diff --git a/usr.sbin/pkg_add/pkg_create.1 b/usr.sbin/pkg_add/pkg_create.1
index 6aecaae21f5..1d1dc7f8002 100644
--- a/usr.sbin/pkg_add/pkg_create.1
+++ b/usr.sbin/pkg_add/pkg_create.1
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: pkg_create.1,v 1.115 2018/07/30 08:05:06 ajacoutot Exp $
+.\"	$OpenBSD: pkg_create.1,v 1.116 2019/11/12 16:37:48 espie Exp $
 .\"
 .\" Documentation and design originally from FreeBSD. All the code has
 .\" been rewritten since. We keep the documentation's notice:
@@ -21,7 +21,7 @@
 .\" [jkh] Took John's changes back and made some additional extensions for
 .\" better integration with FreeBSD's new ports collection.
 .\"
-.Dd $Mdocdate: July 30 2018 $
+.Dd $Mdocdate: November 12 2019 $
 .Dt PKG_CREATE 1
 .Os
 .Sh NAME
@@ -305,7 +305,9 @@ Directory names are denoted by a trailing slash.
 There are some annotations that can be inserted for better control.
 All these commands start with an
 .Sq @ .
-The following annotations can be inserted manually:
+The following annotations can be inserted manually (but commonly
+.Xr update-plist 1
+is used for creating most packing-list contents):
 .Pp
 .Bl -tag -width Ds -compact
 .It Cm @ask-update Ar pkgspec Ar message
@@ -803,6 +805,15 @@ to handle shells.
 See
 .Xr shells 5 .
 .Pp
+.It Cm @so Ar filename
+Describe the file as an
+.Ox
+shared object.
+.Pp
+.It Cm @static-lib Ar filename
+Describe the file as a
+.Ox
+static library.
 .It Cm @unexec Ar command
 Execute
 .Ar command
@@ -850,6 +861,15 @@ except it only gets executed while removing an old package during updates,
 and not during true deletions.
 .El
 .Pp
+The
+.Cm @bin ,
+.Cm @lib ,
+.Cm @so
+and
+.Cm @static-lib
+annotations are used by the debug packages infrastructure to figure out
+which files may contain debug information.
+.Pp
 See
 .Xr package 5
 for other internal annotations that are automatically added by the
-- 
cgit v1.2.3-59-g8ed1b