pkg/30469: SUBST_* machinery needs to be documented.

[bad%atsec.com@localhost]

>Number:         30469
>Category:       pkg
>Synopsis:       pkgsrc.txt doesn't document the SUBST_* machinery
>Confidential:   no
>Severity:       serious
>Priority:       medium
>Responsible:    pkg-manager
>State:          open
>Class:          doc-bug
>Submitter-Id:   net
>Arrival-Date:   Wed Jun 08 21:40:00 +0000 2005
>Originator:     Christoph Badura
>Release:        NetBSD 2.0_STABLE
>Organization:
        
>Environment:
        
        
System: NetBSD limiting-factor 2.0_STABLE NetBSD 2.0_STABLE (GENERIC_LAPTOP) 
#3: Thu Apr 21 21:26:50 MEST 2005 
bad@limiting-factor:/m/src/sys/arch/i386/compile/GENERIC_LAPTOP i386
Architecture: i386
Machine: i386
>Description:
While grepping a bunch of pkgsrc Makefiles for references to SUBST one
sees lines like the following:

unison/Makefile:SUBST_CLASSES=          x11
unison/Makefile:SUBST_STAGE.x11=        post-patch
unison/Makefile:SUBST_FILES.x11=        Makefile.OCaml
unison/Makefile:SUBST_SED.x11=          -e "s|/usr/X11R6|${X11BASE}|g"
unison/Makefile:SUBST_MESSAGE.x11=      "Fixing X11 paths."

Those variables aren't documented in pkgsrc.txt, though.
        
>How-To-Repeat:
        code inspection
        
>Fix:
        

>Unformatted: