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...

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