diff options
author | Marc Espie <espie@cvs.openbsd.org> | 2000-07-09 15:08:49 +0000 |
---|---|---|
committer | Marc Espie <espie@cvs.openbsd.org> | 2000-07-09 15:08:49 +0000 |
commit | 6b7db2c4ed1f880163d8103fc67fcec9cfdbfe9b (patch) | |
tree | 557271f8724d7b36c9896ac3f0d9c55864d360d3 /share/man/man5 | |
parent | ca8e08b4f554e168107ed3cbda3104ecd1edd913 (diff) |
Explains how package information is generated.
Not satisfying yet, I need to take FLAVORS and MULTI_PACKAGES information
out of the way, so that not everything is jumbled together.
Diffstat (limited to 'share/man/man5')
-rw-r--r-- | share/man/man5/bsd.port.mk.5 | 120 |
1 files changed, 117 insertions, 3 deletions
diff --git a/share/man/man5/bsd.port.mk.5 b/share/man/man5/bsd.port.mk.5 index e9c28a14c55..7246c935296 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.7 2000/07/04 16:28:33 espie Exp $ +.\" $OpenBSD: bsd.port.mk.5,v 1.8 2000/07/09 15:08:48 espie Exp $ .\" .\" Copyright (c) 2000 Marc Espie .\" @@ -232,6 +232,11 @@ is replaced by a of the form: .Sq libname.[version.[subversion]] . See BUGS AND LIMITATIONS as well. +.Pp +On architectures that use dynamic libraries, +.Ev LIB_DEPENDS +is also used as a running time dependency, and recorded in the package as +such. .It Ev FULLDISTDIR Complete path to directory where ${DISTFILES} and ${PATCHFILES} will be located, to be used in hand-crafted extraction targets (read-only). @@ -395,6 +400,11 @@ Note that WRKSRC may be a symbolic link, if set to ${WRKDIR}. Subdirectory of ${WRKDIR} where the actual build occurs. Defaults to ${WRKSRC}, unless SEPARATE_BUILD is involved, in which case it is set to an appropriate value. +.It Ev WRKPKG +Subdirectory of ${WRKBUILD} where package information gets generated. +Defaults to ${WKRBUILD}/pkg, do not override unless +.Sq pkg +conflicts with the port's conventions. .It Ev WRKINST Subdirectory of ${WRKDIR} where port normally installs (see .Ar fake @@ -433,9 +443,14 @@ and is always appended. Don't override. Set .Ev EXTRACT_ONLY to nothing and override -.Ar post-extract instead. +.Ar post-extract +instead. .It Ar fetch-list -Use the more powerful mirror-maker and fetch-makefile targets instead. +Use the more powerful +.Ar mirror-maker +and +.Ar fetch-makefile +targets instead. .El .Sh OBSOLETE VARIABLES .Bl -tag -width MASTER_SITES @@ -609,6 +624,9 @@ to marshall system configuration files. All system configuration files are located in /etc, or in a subdirectory of /etc. .El +.\" +.\" +.\" .Sh THE FAKE FRAMEWORK The .Ar fake @@ -666,6 +684,98 @@ to ensure that the right values are passed down to submakes. .\" .\" .\" +.Sh FLAVORS AND MULTI_PACKAGES +Starting with +.Ox 2.7 , +each port can generate several packages through two orthogonal mechanims. +.Sh THE GENERATION OF PACKING INFORMATION +Starting after +.Ox 2.7 +(around revision 1.300 of bsd.port.mk), all packing information is +generated from templates in ${PKGDIR}. + +.Bl -bullet -compact +.It +If not overriden by the user, determine which set of templates to use, +depending on the current SUBPACKAGE and FLAVOR information. +Set ${PLIST}, ${DESCR}, ${COMMENT}, ${MESSAGE} accordingly. +.It +Detect the existence of ${PKGDIR}/{REQ,INSTALL,DEINSTALL}${SUBPACKAGE}. +Modify PKG_ARGS accordingly, to use the generated files, and add +dependencies to regenerate the files if the templates change. +.It +Generate the actual DESCR, and if needed, MESSAGE, REQ, INSTALL, DEINSTALL +from the templates in ${DESCR}, ${MESSAGE}, ${PKGDIR}/REQ${SUBPACKAGE}, +${PKGDIR}/INSTALL${SUBPACKAGE}, ${PKGDIR}/DEINSTALL${SUBPACKAGE}, by +substituting the variables in ${SUBST_VARS}, and by substituting +${FLAVORS} with the canonical flavor extension for this port, +e.g, if FLAVORS=no_map gfx qt2, if FLAVOR=gfx no_map, this is +.Sq -no_map-gfx . +.It +Generate the actual PLIST from the template ${PLIST}, +by inserting shared/no-shared fragments, applying a possible user-supplied +pipeline, merging other fragments, applying the same variable +substitutions as other packing information, and finally handling +dynamic libraries macros. +.El +.Pp +Note that ${COMMENT} is currently not substituted, to speed up +.Ar describe +generation. +.Pp +To avoid substitution, variables can be escaped as follows: +.Li "$\e{PREFIX}" +.Pp +Constructs such as the line +.Li "%%SHARED%%" +or +.Li "%%!SHARED%%" +in the packing-list template trigger the inclusion of the +.Pa ${PKGDIR}/PFRAG.shared${SUBPACKAGE} +or +.Pa ${PKGDIR}/PFRAG.no-shared${SUBPACKAGE} . +.br +Similarly, if FLAVORS lists flav1, then the line +.Li "%%flav1%%" +(resp. +.Li "%%!flav1%%" ) +will trigger the inclusion of +.Pa ${PKGDIR}/PFRAG.flav1${SUBPACKAGE} +(resp. +.Pa ${PKGDIR}/PFRAG.no-flav1${SUBPACKAGE} ) +in the packing-list. Fragments that cannot be handled by these simple rules +can always be specified in a custom SED_PLIST. +.Pp +The constructs +.Li "DYNLIBDIR(directory)" +and +.Li "NEWDYNLIBDIR(directory)" +should be used in +.Pa ${PKGDIR}/PFRAG.shared${SUBPACKAGE} +to register directories that hold dynamic libraries (see +.Xr ldconfig 8 ). +.Li "NEWDYNLIBDIR" +is meant for directories that will go away when the package is deleted. +.Pp +The special +.Ar plist +target does a fairly good job of automatically generating PLIST-auto and +PFRAG.shared-auto fragments. +.Pp +In MULTI_PACKAGES mode, there is a main package that is built after several +SUBPACKAGEs: make package is invoked recursively, after setting SUBPACKAGE +to the right value. All SUBPACKAGEs should start with a dash, e.g., +.Sq -lib +is a correct name. +.Pp +In MULTI_PACKAGES mode, there must be separate COMMENT, DESCR, and PLIST +templates for each SUBPACKAGE (and optional distinct MESSAGE, REQ, INSTALL, +DEINSTALL files in a similar way). This contrasts with the FLAVORS +situation, where all these files will automatically default to the +non-flavor version if there is no flavor-specific file around. +.\" +.\" +.\" .Sh BUGS AND LIMITATIONS .Ev LOCALBASE , .Ev X11BASE @@ -686,6 +796,10 @@ over the years. .Pp When the file grew too large, Marc Espie cleaned it up to restore some of its speed and remove a lot of bugs. +.Pp +FLAVORS, MULTI_PACKAGES and FAKE are +.Ox +improvements. .\" Voluntarily undocumented: .\" AUTOCONF_ENV: probably not needed anyway, should be internal. |