More stuff: checksum process, fix REFETCH description.

Describe CATEGORIES, DISTNAME.

1 files changed, 53 insertions, 30 deletions

diff --git a/share/man/man5/bsd.port.mk.5 b/share/man/man5/bsd.port.mk.5
index 2c38b99fc69..4a87a295060 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.21 2000/12/14 13:26:26 espie Exp $
+.\" $OpenBSD: bsd.port.mk.5,v 1.22 2000/12/27 18:21:11 espie Exp $
 .\"
 .\" Copyright (c) 2000 Marc Espie
 .\"
@@ -46,6 +46,11 @@ Conversion methods are outlined here.
 This is an incomplete draft; some variables and targets are not yet documented.
 .Sh TARGETS
 .Bl -tag -width do-configure
+.It Ar addsum
+Complete the ${CHECKSUM_FILE} record of checksums with files that have been
+added since
+.Ar makesum .
+Complain if anything does not match.
 .It Ar build , Ar all
 Default target.
 Build the port.
@@ -59,6 +64,19 @@ Debugging version of the
 .Ar patch
 target that simulates invoking
 .Xr patch 1 .
+.It Ar checksum
+Check distribution archives and distribution patches control sum against
+the results recorded in ${CHECKSUM_FILE},
+using the cryptographic signature utilities listed in ${PREFERRED_CIPHERS}.
+Normally ${ALLFILES}
+are checksummed, unless
+.Ev IGNOREFILES
+is set to a list of files to ignore.
+Invoking
+.Ar checksum
+with REFETCH=true
+will try to fetch a version of with mismatched checksums off the OpenBSD
+main archive site.
 .It Ar configure
 Configure the port.
 Might be a void operation.
@@ -113,10 +131,8 @@ The ports framework uses
 (aliased to
 .Pa ${FULLDISTDIR} )
 to cache the ports distribution files and patch files.
-Note that
-.Ar fetch
-can be invoked by mirroring scripts, in which case it will also
-retrieve
+Note that this framework is also used by mirroring scripts,
+which will also retrieve
 .Ev SUPDISTFILES ,
 to fill with supplementary distribution files which are not needed for
 every configuration.
@@ -133,7 +149,11 @@ See
 .Ev MASTER_SITES9 ,
 .Ev PATCH_FILES ,
 .Ev SUPDISTFILES ,
-.Ar refetch .
+.Ev REFETCH .
+.It Ar makesum
+Create the ${CHECKSUM_FILE} list of recorded checksums by running the
+cryptographic fingerprints sha1, md5 and rmd160 on ${ALLFILES} minus
+${IGNOREFILES}.
 .It Ar patch
 Apply distribution and
 .Ox
@@ -167,15 +187,6 @@ exists, the files described under
 .Ev PATCH_LIST
 will be applied under
 .Ev WRKDIST .
-.It Ar refetch
-Try grabbing a version of the distfiles with the correct checksum off
-the main
-.Ox
-mirror, if
-.Ar fetch
-+
-.Ar checksum
-failed.
 .It Ar show
 Invoked with VARNAME=name, show the contents of VARNAME.
 Mostly used from recursive makes, or to know the contents of another
@@ -224,6 +235,10 @@ is set relative to ${PORTSDIR}.
 Build dependencies are checked at the beginning of the extract stage.
 .It Ev BZIP2
 Name of the bzip2 binary.
+.It Ev CATEGORIES
+List of descriptive categories into which this port fails. Mandatory. See
+.Ar link-categories ,
+.Ar unlink-categories .
 .It Ev CDROM_PACKAGES
 Base location where packages suitable for a CDROM (see
 PERMIT_PACKAGE_CDROM) will be placed
@@ -245,9 +260,11 @@ Many ports ignore it.
 See also
 .Ev COPTS .
 .It Ev CHECKSUM_FILE
-Location for this port checksums, used at
-.Ar checksum
-stage.
+Location for this port checksums, used by
+.Ar addsum ,
+.Ar checksum ,
+and
+.Ar makesum .
 Defaults to ${FILESDIR}/md5.
 .It Ev CLEANDEPENDS
 If set to
@@ -341,6 +358,11 @@ appended to select a different
 .Ev MASTER_SITES .
 See also
 .Ev SUPDISTFILES .
+.It Ev DISTNAME
+Name used to identify the port. See
+.Ev DISTFILES
+and
+.Ev PKGNAME .
 .It Ev DISTORIG
 Suffix used by
 .Ar distpatch
@@ -444,6 +466,9 @@ PERMIT_PACKAGE_FTP) will be placed
 .It Ev GMAKE
 Location of the gnu make binary, if needed.
 Defaults to gmake.
+.It Ev IGNOREFILES
+Set to the list of files that cannot be checksummed. For used by ports
+fetching dynamically generated archives that can't be checksummed.
 .It Ev LIB_DEPENDS
 Libraries this port depends upon.
 Similar to BUILD_DEPENDS, except that
@@ -620,6 +645,12 @@ The first cipher that matches in ${CHECKSUM_FILE} is verified.
 Base directory for the current port installation.
 Usually ${LOCALBASE}, though some ports may elect a location under /var,
 and some multi-package ports may install under several locations.
+.It Ev REFETCH
+If set to true,
+.Ar checksum
+will analyze ${CHECKSUM_FILE}, and try retrieving files with the correct
+checksum off ftp.openbsd.org, in the directory
+.Pa /pub/OpenBSD/distfiles/$cipher/$value/$file .
 .It Ev RUN_DEPENDS
 Specification of ports this port needs installed to be functional.
 Same format as BUILD_DEPENDS.
@@ -815,18 +846,10 @@ Set
 to nothing and override
 .Ar post-extract
 instead.
-.It Ar fetch-list
-Use the more powerful
-.Ar mirror-maker
-and
-.Ar fetch-makefile
-targets instead.
-.It Ar mirror-distfiles
-Use the more powerful
-.Ar mirror-maker
-and
-.Ar fetch-makefile
-targets instead.
+.It Ar fetch-all , Ar fetch-list , Ar mirror-distfiles
+See
+.Xr mirroring-ports 7
+for more efficient and flexible ways to build mirrors.
 .El
 .Sh OBSOLETE VARIABLES
 .Bl -tag -width MASTER_SITES