> One way of providing such documentation (aside from good writing) is
> to provide a worked example. The Debian Linux release (www.debian.org)
> includes a "package" of GNU Hello 1.3; it's quite neat, because it

Fair enough.   Check out 

ftp://ftp.quick.com.au/pub/netbsd/pkg-example.shar.Z

It contains:

# Contents: 
#       Makefile
#       kshenv.pkg
#       kshenv.README
#       kshenv.oneline
#       pdksh.pkg
#       pdksh.README
#       pdksh.oneline
#       pdksh.patch
#

To build a package such as pdksh-i386.tgz or pdksh-sparc.tgz

I just cd ~/packages and type make.

BTW, ftp://ftp.quick.com.au/pub/netbsd/kshenv.tgz conatins the latest
version of my sh,ksh setup stuff. 

--sjg