Document PKGNAMES, print-package-signature, PLIST_DB.

Fix a few minor errors.
Synch history with reality more.

1 files changed, 41 insertions, 5 deletions

diff --git a/share/man/man5/bsd.port.mk.5 b/share/man/man5/bsd.port.mk.5
index 8342d32b9be..54ad6ea040e 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.162 2005/07/26 19:43:07 jmc Exp $
+.\" $OpenBSD: bsd.port.mk.5,v 1.163 2005/09/04 22:35:48 espie Exp $
 .\"
 .\" Copyright (c) 2000 Marc Espie
 .\"
@@ -283,6 +283,8 @@ by checking the library specifications.
 .It Ar lib-depends-check
 Verify that the
 .Ev LIB_DEPENDS
+and
+.Ev WANTLIB
 hold all shared libraries used for the port.
 See
 .Xr library-specs 7 .
@@ -374,6 +376,10 @@ See also
 for possible
 .Ar post-patch
 clean-up.
+.It Ar print-package-signature
+Print the package signature, in the same format used for
+.Xr pkg_info 1
+.Fl S .
 .It Ar readmes
 Create an html description of packages, including comments, description,
 and dependencies.
@@ -1327,12 +1333,27 @@ This does not take flavors into account.
 See
 .Ev FULLPKGNAME
 for that.
+.It Ev PKGNAMES
+Read-only.
+List of all package names generated by the port, with
+.Ev FLAVORS
+and
+.Ev MULTI_PACKAGES
+taken into account.
+Mostly used as
+.Sq make show=PKGNAMES
+to verify that bumped package names are correct.
 .It Ev PKGNAME-foo
 Package name for sub-package foo, if the default value
 of ${PKGNAME}${SUBPACKAGE} is not appropriate.
 .It Ev PKGPATH
 Path to the current port's directory, relative to ${PORTSDIR}.
 Read-only.
+.It Ev PLIST_DB
+User settings.
+Directory used to save generated packing-lists, for further processing,
+such as looking for unregistered conflicts.
+Defaults to empty.
 .It Ev PREFERRED_CIPHERS
 List of cryptographic ciphers to use, in order of preference.
 Default is
@@ -1738,7 +1759,7 @@ Renamed into
 .Ar print-build-depends
 .It Ar print-package-depends
 Renamed into
-.It Ar print-run-depends
+.Ar print-run-depends
 .El
 .Sh OBSOLETE VARIABLES
 .Bl -tag -width MASTER_SITES
@@ -2239,6 +2260,18 @@ The special
 target does a fairly good job of automatically generating PLIST and
 PFRAG.shared fragments.
 .Pp
+If
+.Ev PLIST_DB
+points to a directory, all packing-lists generated by
+.Xr pkg_create 1
+during the
+.Ar package
+stage are saved in that location in a timeless format:
+md5 and size information are removed, as well as build specificities.
+Since a package name must always be changed when the packing-list changes,
+any attempt to replace a packing-list of a given name with a different
+packing-list will be flagged as an error.
+.Pp
 In MULTI_PACKAGES mode, there must be separate COMMENT, DESCR, and PLIST
 templates for each SUBPACKAGE (and optional distinct MESSAGE, UNMESSAGE,
 REQ, INSTALL, DEINSTALL files in a similar way).
@@ -2258,14 +2291,17 @@ The ports mechanism originally came from
 .Fx .
 A lot of additions were taken from
 .Nx
-over the years.
+over the seminal years.
 .Pp
-When the file grew too large, it was cleaned up to restore some of
-its speed and remove a lot of bugs.
+Since 1998, the framework has been systematically cleaned-up and reorganized
+to remove bugs.
+New features have been carefully introduced, trying hard to avoid 
+inconsistencies.
 .Pp
 FLAVORS, MULTI_PACKAGES and FAKE are
 .Ox
 improvements.
+Most recent additions do not come from another BSD.
 .\" Voluntarily undocumented:
 .\" AUTOCONF_ENV: probably not needed anyway, should be internal.
 .Sh BUGS AND LIMITATIONS