More

1 files changed, 64 insertions, 2 deletions

diff --git a/share/man/man5/bsd.port.mk.5 b/share/man/man5/bsd.port.mk.5
index 0b5d7496f74..7435b5300d8 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.3 2000/06/10 19:23:04 espie Exp $
+.\" $OpenBSD: bsd.port.mk.5,v 1.4 2000/06/10 22:32:55 espie Exp $
 .\"
 .\" Copyright (c) 2000 Marc Espie
 .\"
@@ -96,7 +96,10 @@ autoreconf might be more appropriate).
 Where to invoke autoconf if ${CONFIGURE_STYLE} includes autoconf.
 Defaults to ${WRKSRC}.
 .\" AUTOCONF_DIR should probably be a list, and be renamed to AUTOCONF_DIRS ?
-.It BUILD_DEPENDS
+.It Ev BSD_INSTALL_{PROGRAM,SCRIPT,DATA,MAN}[_DIR]
+Macros passed to make and configure invocations. Set based on corresponding
+INSTALL_* variables.
+.It Ev BUILD_DEPENDS
 List of other ports the current port needs to build correctly.
 Each item has the form 
 .Sq file_to_test::directory[:target] .
@@ -131,6 +134,12 @@ If set to
 .Sq make clean
 will also clean dependencies. Note that distclean  never recurses down to
 dependencies.
+.It Ev COMMENT
+File used as a comment for the package, and in the INDEX. Set to
+${PKGDIR}/COMMENT by default (with corrections for multi-packages and flavors).
+If COMMENT starts with a dash, this is a litteral string instead. This can
+be used to leave a stub Makefile for removed ports and have a complete
+INDEX entry without needing more files.
 .It Ev CONFIGURE_SCRIPT
 Set to name of script invoked by 
 .Ar configure 
@@ -171,6 +180,10 @@ ${CFLAGS} ${COPTS} as CFLAGS.
 .It Ev DIST_SUBDIR
 Optionally subdirectory of ${DISTDIR} where the current port's distfiles
 and patchfiles will be located. See target fetch.
+.It Ev ECHO_MSG
+Used to display 
+.Sq ===> Configuring for foo
+and similar informative messages. Override to turn off, for instance.
 .It Ev FAKE
 Automatically set to 
 .Sq Yes
@@ -215,6 +228,9 @@ See BUGS AND LIMITATIONS as well.
 .It Ev FULLDISTDIR
 Complete path to directory where ${DISTFILES} and ${PATCHFILES} will be
 located, to be used in hand-crafted extraction targets (read-only).
+.It Ev INSTALL_{PROGRAM,SCRIPT,DATA,MAN}[_DIR]
+Macros to use to install a program, a script, a man page, or data (or the
+corresponding directory, respectively).
 .It Ev IS_INTERACTIVE
 Set to
 .Sq Yes
@@ -231,12 +247,22 @@ Arguments to pass to libtool. If USE_LIBTOOL is set, the environment variable
 LIBTOOL is set to ${LIBTOOL} ${LIBTOOL_FLAGS}.
 .It Ev LOCALBASE
 where other ports have already been installed (default: /usr/local)
+.It Ev MAKE_ENV
+Environment variables passed to make invocations. Sets at least
+PATH, PREFIX, LOCALBASE, X11BASE, CFLAGS, TRUEPREFIX, DESTDIR and the
+BSD_INSTALL_* macros.
 .It Ev MAKE_FLAGS
 Flags used for all make invocations, except for the fake stage, which uses
 FAKE_FLAGS.
+.It Ev MAKE_FILE
+Name of the Makefile used for ports building. Defaults to Makefile. Used
+after changing directory to ${WRKBUILD}.
 .It Ev MAKE_PROGRAM
 The make program that is used for building the port. Set to ${MAKE} or
 ${GMAKE} depending on USE_GMAKE. Read-only.
+.It Ev MESSAGE
+File recorded in the package and displayed during installation. Defaults
+to ${PKGDIR}/MESSAGE if this file exists. Leave empty if no message is needed.
 .It Ev MTREE_FILE
 .Xr mtree 1
 specification to check when creating a PLIST with the
@@ -291,6 +317,13 @@ Same format as BUILD_DEPENDS.  The corresponding packages will be built at
 stage, and 
 .Xr pkg_add 1
 will take care of installing them.
+.It Ev SED_PLIST
+Pipeline of commands used to create the actual packing list from the 
+PLIST template (usually ${PKGDIR}/PLIST). 
+.Nm
+appends to it substitution commands corresponding to the the port's 
+FLAVOR and variables from SUBST_VARS.
+${SED_PLIST} is invoked as a pipeline after inserting PFRAG.shared fragments.
 .It Ev SCRIPTDIR
 Location for scripts related to the current port (default: scripts.${ARCH}
 or scripts).
@@ -314,6 +347,10 @@ if distinct flavors of the port may share a common source tree.
 Set to the sub package suffix when building a package in a multi-package
 port. Read-only. Used to test for dependencies or to adjust the package
 name.
+.It Ev SUBST_VARS
+Make variables whole values get substituted to create the actual package
+information.  Always holds ARCH, HOMEPAGE, and PREFIX. Add other 
+variables as needed.
 .It Ev SYSCONFDIR
 Location for ports system configuration files. Defaults to /etc, should
 never be set to /usr/local/etc.
@@ -381,6 +418,13 @@ Use the more powerful mirror-maker and fetch-makefile targets instead.
 .El
 .Sh OBSOLETE VARIABLES
 .Bl -tag -width MASTER_SITES
+.It Ev DESCR_SRC
+From 
+.Nx .
+This is DESCR. 
+.Ox
+does not give a specific name to the generated file. It is not recommended
+to try to access them directly.
 .It Ev GNU_CONFIGURE
 Use 
 .Ev CONFIGURE_STYLE
@@ -444,6 +488,21 @@ becomes
 	PATCH_FILES=foo.diff.gz:0
 	MASTER_SITES0=ftp://ftp.zoinx.org/pub/
 .Ed
+.It Ev PLIST_SRC
+From 
+.Nx .
+This is PLIST. 
+.Ox
+does not give a specific name to the generated file. It is not recommended
+to try to access them directly.
+.It Ev PLIST_SUBST
+From
+.Nx .
+Use SUBST_VARS instead.  
+.Ox
+does not allow general substitutions of the form VAR=value, but uses
+only a list of variables instead.  Most package files gets transformed,
+instead of only the packing list.
 .It Ev USE_AUTOCONF
 Use
 .Ev CONFIGURE_STYLE
@@ -570,6 +629,9 @@ port that mentions DESTDIR=    does not need any patch to work with fake.
 .Pp
 Recursive makes are a problem, and will often need FAKE_FLAGS to be changed
 to ensure that the right values are passed down to submakes.
+.\"
+.\"
+.\"
 .Sh BUGS AND LIMITATIONS
 .Ev LOCALBASE ,
 .Ev X11BASE