pkg/32544: CREATE_WRKDIR_SYMLINK is not documented

[mlelstv%serpens.de@localhost]

>Number:         32544
>Category:       pkg
>Synopsis:       CREATE_WRKDIR_SYMLINK is not documented
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    pkg-manager
>State:          open
>Class:          doc-bug
>Submitter-Id:   net
>Arrival-Date:   Mon Jan 16 10:15:00 +0000 2006
>Originator:     Michael van Elst
>Release:        NetBSD 3.0_STABLE
>Organization:
-- 
                                Michael van Elst
Internet: mlelstv%serpens.de@localhost
                                "A potential Snark may lurk in every tree."
>Environment:
        
        
System: NetBSD henery 3.0_STABLE NetBSD 3.0_STABLE (HENERY) #23: Thu Jan 12 
21:50:28 CET 2006 src@henery:/usr/obj/home/src/sys/arch/i386/compile/HENERY i386
Architecture: i386
Machine: i386
>Description:
pkgsrc creates work directories in the source directory unless you
define the WRKOBJDIR variable in mk.conf or elsewhere. In that case
the work directory is created under the given path and a symlink
is create in the source directory.

If the source directory is read-only the symlink is not created
but this isn't seen as an error.

There is an undocumented variable CREATE_WRKDIR_SYMLINK that will
also prevent the symlink from being created if you set it to 'no'.

That variable however is not documented in the pkgsrc guide.

>How-To-Repeat:
        
>Fix:
Please provide documentation.

>Unformatted: