Hi,
Some suggested corrections to bsd.port.mk.5 man page patch attached, text was
BUILD_PKGPATH
Full pkgpath to the current port, taking flavors and
pseudo-flavors into account. Mostly useful to write
dependencies for subpackages like this:
LIB_DEPENDS-foo=::${BUILD_PKGPATH} and avoid starting to
build a package with some other flavor combination. Read-
only.
Should have that :: removed now, and spaces are preferred, before/after =, +=,
when used in Makefiles, example
FAKEOBJDIR_www/mozilla=/tmp/obj
is changed to
FAKEOBJDIR_www/mozilla = /tmp/obj
Regards
Nigel Taylor
Index: share/man/man5/bsd.port.mk.5
===================================================================
RCS file: /home/cvs/src/share/man/man5/bsd.port.mk.5,v
retrieving revision 1.276
diff -u -r1.276 bsd.port.mk.5
--- share/man/man5/bsd.port.mk.5 11 Dec 2010 10:41:30 -0000 1.276
+++ share/man/man5/bsd.port.mk.5 10 Feb 2011 16:00:33 -0000
@@ -771,7 +771,7 @@
Full pkgpath to the current port, taking flavors and pseudo-flavors
into account.
Mostly useful to write dependencies for subpackages like this:
-.Li "LIB_DEPENDS-foo=::${BUILD_PKGPATH}"
+.Li "LIB_DEPENDS-foo\ =\ ${BUILD_PKGPATH}"
and avoid starting to build a package with some other flavor combination.
Read-only.
.It Ev BULK
@@ -1081,7 +1081,7 @@
For instance:
.Bd -literal -offset indent
\&.if !defined(COMMENT)
-ERRORS+="Fatal: Missing comment"
+ERRORS += "Fatal: Missing comment"
\&.endif
.Ed
.It Ev EXTRACT_CASES
@@ -1128,7 +1128,7 @@
If non empty, used as a base for the fake area.
The real fake directory ${WRKINST} is created there.
Can be set on a per-${PKGPATH} basis.
-For instance, setting FAKEOBJDIR_www/mozilla=/tmp/obj
+For instance, setting FAKEOBJDIR_www/mozilla\ =\ /tmp/obj
will affect only the mozilla port.
.It Ev FETCH_CMD
Command used to fetch distribution files for this port.
@@ -1142,9 +1142,9 @@
.Ev FETCH_MANUALLY
to a list of strings that will be displayed, one per line, e.g.,
.Bd -literal
-FETCH_MANUALLY= "You must fetch foo-1.0.tgz"
-FETCH_MANUALLY+="from http://www.fubar.com/ manually,"
-FETCH_MANUALLY+="after reading and agreeing to the license."
+FETCH_MANUALLY = "You must fetch foo-1.0.tgz"
+FETCH_MANUALLY += "from http://www.fubar.com/ manually,"
+FETCH_MANUALLY += "after reading and agreeing to the license."
.Ed
Automatically sets
.Ev IS_INTERACTIVE
@@ -1580,7 +1580,7 @@
can hold absolute pathnames, for instance to share patches among similar
ports:
.Bd -literal
-PATCH_LIST=${PORTSDIR}/x11/kde/libs2/patches/p-* patch-*
+PATCH_LIST = ${PORTSDIR}/x11/kde/libs2/patches/p-* patch-*
.Ed
.It Ev PATCH_STRIP
Patch option used to strip directory levels while applying port's patches.
@@ -2119,14 +2119,14 @@
${PORTSDIR}/pobj).
The real working directory ${WRKDIR} is created there.
Can be set on a per-${PKGPATH} basis.
-For instance, setting WRKOBJDIR_www/mozilla=/tmp/obj
+For instance, setting WRKOBJDIR_www/mozilla\ =\ /tmp/obj
will affect only the mozilla port.
If explicitly unset (WRKOBJDIR=), the working directory is
created within the port directory.
.It Ev X11BASE
Where X11 has been installed (default: /usr/X11R6).
.It Ev XMKMF
-Invocation of xmkmf for CONFIGURE_STYLE=imake port.
+Invocation of xmkmf for CONFIGURE_STYLE\ =\ imake port.
Defaults to xmkmf -a -DPorts.
The -DPorts is specific to
.Ox
@@ -2408,7 +2408,7 @@
All ports should have a working directory, as this is necessary to store
cookies and keep state.
.It Ev NO_WRKSUBDIR
-The same functionality is obtained by setting WRKDIST=${WRKDIR} .
+The same functionality is obtained by setting WRKDIST\ =\ ${WRKDIR}\ .
.It Ev NOCLEANDEPENDS
Use CLEANDEPENDS instead.
.It Ev NOMANCOMPRESS
@@ -2454,14 +2454,14 @@
.Sq :9
extension to the file name, e.g.,
.Bd -literal -offset indent
-PATCHFILES=foo.diff.gz
-PATCH_SITES=ftp://ftp.zoinx.org/pub/
+PATCHFILES = foo.diff.gz
+PATCH_SITES = ftp://ftp.zoinx.org/pub/
.Ed
.Pp
becomes
.Bd -literal -offset indent
-PATCHFILES=foo.diff.gz:0
-MASTER_SITES0=ftp://ftp.zoinx.org/pub/
+PATCHFILES = foo.diff.gz:0
+MASTER_SITES0 = ftp://ftp.zoinx.org/pub/
.Ed
.It Ev PKG_CMD
replaced by
@@ -2693,7 +2693,7 @@
The port maintainer will set FLAVORS to be the list of possible options in
the Makefile.
When building the port, the package builder will set
-.Li "FLAVOR='option1 option2...'"
+.Li "FLAVOR\ =\ 'option1\ option2...'"
to build a specific flavor of the port.
The Makefile should test the value of FLAVOR as follows:
.Bd -literal -offset indent
@@ -2717,10 +2717,10 @@
to prevent misspellings.
.Pp
In recursive package building, flavors can be specified as a comma
-separated list after the package directory, e.g., SUBDIR+=vim,no_x11.
+separated list after the package directory, e.g., SUBDIR\ +=\ vim,no_x11.
.Pp
Finally, package information will use templates with the canonical package
-extension if they are available: if FLAVOR='option1 option2' and both
+extension if they are available: if FLAVOR\ =\ 'option1\ option2' and both
COMMENT and COMMENT-option1-option2 are available, COMMENT-option1-option2 will
be used.
.Pp
@@ -2729,14 +2729,14 @@
Each extension of a MULTI_PACKAGES name should start with a dash, so that
they cannot be confused with FLAVORS.
In dependency checking and recursive builds, a subpackage can be
-specified after a comma, e.g., SUBDIR+=quake,-server.
+specified after a comma, e.g., SUBDIR\ +=\ quake,-server.
MULTI_PACKAGES only affects the actual package building step (and the
describe step, since a MULTI_PACKAGES port will produce several
descriptions).
.Pp
If MULTI_PACKAGES is set, the packaging stage happens once for every
subpackage, using subpackage-specific variables.
-For instance, if MULTI_PACKAGES=-main -lib -server,
+For instance, if MULTI_PACKAGES\ =\ -main\ -lib\ -server,
.Ev PKG_ARCH-main ,
.Ev PKG_ARCH-lib
and
@@ -2778,8 +2778,8 @@
The usual non-MULTI_PACKAGES variables are simply used as default values
for all subpackages.
So, if you set
-.Li "PKG_ARCH=*"
-.Li "PKG_ARCH-main=i386"
+.Li "PKG_ARCH\ =\ *"
+.Li "PKG_ARCH-main\ =\ i386"
then
.Ev PKG_ARCH-lib
and
@@ -2872,7 +2872,7 @@
from the templates in ${DESCR}, ${MESSAGE}, ${UNMESSAGE}, 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
+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},
