document SUBST_CMD* again, hopefully for the last time.

1 files changed, 13 insertions, 6 deletions

diff --git a/share/man/man5/bsd.port.mk.5 b/share/man/man5/bsd.port.mk.5
index 4b8a0dc566a..f1f72d4d876 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.352 2012/08/22 13:54:01 espie Exp $
+.\" $OpenBSD: bsd.port.mk.5,v 1.353 2012/08/31 16:52:40 espie Exp $
 .\"
 .\" Copyright (c) 2000-2008 Marc Espie
 .\"
@@ -24,7 +24,7 @@
 .\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
 .\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 .\"
-.Dd $Mdocdate: August 22 2012 $
+.Dd $Mdocdate: August 31 2012 $
 .Dt BSD.PORT.MK 5
 .Os
 .Sh NAME
@@ -2532,9 +2532,17 @@ and/or
 .Pp
 Note that
 .Ev SUBST_CMD
-is subpackage-dependent and aware of subpackage semantics, like
-packing-list substitution.
-It will substitute the right variable depending on the current subpackage,
+is not really appropriate when variables have subpackage variations, like
+.Ev PREFIX
+or
+.Ev FULLPKGNAME .
+Use the appropriate
+.Ev SUBST_CMD-sub
+instead.
+.It Ev SUBST_CMD-sub
+.Ev SUBST_CMD
+with subpackage-dependent semantics, like packing-list substitution.
+It will substitute the right variable depending on the desired subpackage,
 e.g.,
 .Ev SUBST_CMD-foo
 will substitute the value of
@@ -3231,7 +3239,6 @@ The following variables are subpackage dependent:
 .Ev PLIST ,
 .Ev STATIC_PLIST ,
 .Ev PKGSPEC ,
-.Ev SUBST_CMD .
 .Pp
 The usual non-MULTI_PACKAGES variables are simply used as default values
 for all subpackages.