summaryrefslogtreecommitdiff
path: root/share/man
diff options
context:
space:
mode:
authorMarc Espie <espie@cvs.openbsd.org>2006-12-01 17:49:39 +0000
committerMarc Espie <espie@cvs.openbsd.org>2006-12-01 17:49:39 +0000
commit2354a44a1268ec912c3bc2456de5db520f2421c3 (patch)
treea4aaecd7db5e47d7aa4108d6a2eee08a396d27d2 /share/man
parent9fa2a2a8a9da2afe9e7d76785f2e16a9e418d7a9 (diff)
give a more thorough list of subpackage-dependent variable,
rephrase description of package/subpackage to not give the impression one explicitly invokes the other, since it doesn't...
Diffstat (limited to 'share/man')
-rw-r--r--share/man/man5/bsd.port.mk.554
1 files changed, 33 insertions, 21 deletions
diff --git a/share/man/man5/bsd.port.mk.5 b/share/man/man5/bsd.port.mk.5
index ede20b26c8e..0af251caaa7 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.183 2006/11/26 22:03:54 jmc Exp $
+.\" $OpenBSD: bsd.port.mk.5,v 1.184 2006/12/01 17:49:38 espie Exp $
.\"
.\" Copyright (c) 2000 Marc Espie
.\"
@@ -2299,6 +2299,9 @@ The following variables are subpackage dependent:
.Ev PKG_ARCH ,
.Ev PERMIT_PACKAGE_FTP ,
.Ev PERMIT_PACKAGE_CDROM ,
+.Ev PKGNAME
+.Ev FULLPKGNAME ,
+.Ev FULLPKGPATH ,
.Ev RUN_DEPENDS ,
.Ev WANTLIB ,
.Ev LIB_DEPENDS ,
@@ -2336,30 +2339,39 @@ As an exception, any
that references the current port will be ignored as a build dependency,
in order to avoid recursion.
.Pp
-In terms of implementation, quite a few targets will invoke a subpackage
+.Ev FULLPKGPATH
+and
+.Ev FULLPKGNAME
+are special as well.
+You must set
+.Ev PKGNAME-sub
+or
+.Ev FULLPKGNAME-sub
+for each subpackage, and
+.Ev FULLPKGPATH-sub
+is set automatically to the right value.
+In very rare cases, one can override
+.Ev FULLPKGPATH-sub
+(for instance, if one specific subpackage is not affected by option
+settings that affect over subpackages, e.g., for include files packs).
+.Pp
+In terms of implementation, quite a few targets will have a subpackage
specific subtarget:
+invoking
.Ar package
-will invoke
-.Ar subpackage ,
+is the same as invoking
+.Ar subpackage
+for all subpackages,
+invoking
.Ar install-all
-will invoke
-.Ar install ,
+is the same as invoking
+.Ar install
+for all subpackages,
+and invoking
.Ar update
-will invoke
-subupdate ,
-.Ar lib-depends-check
-will invoke
-.Ar sublib-depends-check ,
-.Ar readme
-will invoke
-.Ar subreadme ,
-.Ar describe
-will invoke
-.Ar subdescribe ,
-and
-.Ar dump-vars
-will invoke
-.Ar subdump-vars .
+is the same as invoking
+subupdate
+for all subpackages.
.Sh THE GENERATION OF PACKING INFORMATION
Starting after
.Ox 2.7