document special names that exist in the package system

1 files changed, 19 insertions, 2 deletions

diff --git a/share/man/man7/packages.7 b/share/man/man7/packages.7
index 88d321d2159..6eed9ed00a3 100644
--- a/share/man/man7/packages.7
+++ b/share/man/man7/packages.7
@@ -1,4 +1,4 @@
-.\" $OpenBSD: packages.7,v 1.44 2018/07/10 16:01:48 jmc Exp $
+.\" $OpenBSD: packages.7,v 1.45 2019/12/04 11:07:58 espie Exp $
 .\"
 .\" Copyright (c) 2000 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: July 10 2018 $
+.Dd $Mdocdate: December 4 2019 $
 .Dt PACKAGES 7
 .Os
 .Sh NAME
@@ -239,6 +239,23 @@ using
 .Xr pkg_check-problems 1 .
 Most packages should contain correct annotations, and not allow themselves
 to be installed on top of a conflicting package.
+.Pp
+Some packages follow special naming conventions:
+.Pp
+.Bl -tag -width *-firmware-* -compact
+.It Pa .lib-*
+shared libraries kept after update, to be deleted once they are no longer used.
+.It debug-*
+debug information for the corresponding package.
+.It Pa partial-*
+partial installation of a package that couldn't finish.
+.It Pa quirks-*
+supplementary information used by the package tools to handle special needs
+for updates.
+.It Pa *-firmware-*
+special system packages managed by
+.Xr fw_update 1 .
+.El
 .Sh PACKAGE DEPENDENCIES
 Each package holds a full list of pre-required packages.
 .Xr pkg_add 1