There have been some problems in the past where people updating
pkgsrc/mk/mk.conf.example have inserted comments with leading tabs,
rather than spaces, which has caused make to puke on a number of
occasions, since it expects a leading tab to preface a shell command.

Accordingly, I've gone and changed the layout of pkgsrc/mk/mk.conf.example
to eliminate leading white space. The result is below. At first
glance, I thought it was less readable than the old format. After
subsequent use, I think they're about equally readable, and the
new format is certainly safer, and less verbose.

Comments?

Thanks,
Alistair

# $NetBSD: mk.conf.example,v 1.97 1999/11/12 12:05:02 agc Exp $
#

# Sample /etc/mk.conf file, which can be used to set specific values
# for building either NetBSD or some of the NetBSD packages collection.
# See the NetBSD mk.conf(5) and packages(7) manual page for a full
# description of all available options.
#
# Definitely not complete yet. - agc Fri Mar 27 16:42:38 GMT 1998
#

# ************************************************************************
# NOTE TO PEOPLE EDITING THIS FILE - USE LEADING SPACES, NOT LEADING TABS.
# ************************************************************************

#
#	Firstly, definitions for NetBSD and package collection
#

#MANZ=
# gzip manual pages at installation time
# Possible: defined, not defined
# Default: not defined

#OBJMACHINE=
# use machine-specific object directories, e.g.  work.i386, work.sparc
# Possible: defined, not defined
# Default: not defined

#WRKOBJDIR=	/usr/tmp
# build here instead of in pkgsrc
# Possible: any path
# Default: not defined

#UVM=
# Use the new UVM virtual memory subsystem XXX this variable is
# obsolete - UVM is no longer optional for NetBSD 1.4 and on
# Possible: defined, not defined
# Default: not defined

#USETBL=
# Run raw manual pages through tbl(1) before piping through troff(1)
# when formatting manual pages.
# Possible: defined, not defined
# Default: not defined


#
# The following values are used to manage the packages collection as a whole.
#

#LOCALBASE=	/usr/local
# Where non-X-based packages will be installed
# Possible: any path
# Default: /usr/pkg

#CROSSBASE=	/usr/pkg/cross
# Where "cross" category packages install
# Possible: any path
# Default: ${LOCALBASE}/cross

#X11BASE=	/usr/X11R6
# Where X11 is installed on the system.
# (and the default install path of X11 pkgs)
# Possible: any path
# Default: /usr/X11R6

#MOTIFBASE=	/usr/X11R6
# Where Motif is installed on the system.
# Possible: any path
# Default: /usr/X11R6

#DISTDIR=	${PKGSRCDIR}/distfiles
# Directory where original distribution
# files are stored.
# Possible: any path you like
# Default: /usr/pkgsrc/distfiles

#DIST_PATH=	/cdrom/0/distfiles:${HOME}/distfiles
# colon-delimited list of directories in which to search for
# ${DISTFILES} and ${PATCHFILES}.  If the requested file is not in any
# of the directories in ${DIST_PATH}, it will be downloaded into
# ${DISTDIR}.  If the requested file is in one of the directories in
# ${DIST_PATH}, a symbolic link will be made to it from ${DISTDIR}. 
# ${DIST_PATH} directories will will be searched before ${DISTDIR},
# letting a CD hold the main distfiles archive, and local ${DISTDIR}
# hold any updated distfiles, for example.
# Possible:  any directories
# Default: none

#PACKAGES=       ${PKGSRCDIR}/packages/${MACHINE_ARCH}
# Store generated packages on a per-architecture base
# Possible: any path you like
# Default: /usr/pkgsrc/packages

#PASSIVE_FETCH=
# Use ftp(1) in passive mode, for use behind filtering firewalls. 
# (Set by default in ftp(1) in NetBSD-current)
# Possible: defined, not defined
# Default: not defined

#PATCH_FUZZ_FACTOR?=
# Fuzz factor to use when applying patches.  Will only be applied when
# using a patch(1) that understands -F.  This should be a "?="
# setting, since package Makefiles may set this value, before
# /etc/mk.conf is read.
# Possible: "-Fn" where n is a number, none
# Default: none

#ACCEPTABLE_LICENSES=	shareware no-commercial-use fee-based-commercial-use
# Whitespace-delimited list of the types of license which are
# acceptable for installation.  (apart from standard "free" licenses
# such as Berkeley/CMU and GPL).
# Possible: shareware, no-commercial-use,
# 	fee-based-commercial-use 
# Default: none

#SPECIFIC_PKGS=
# Don't use the default of all packages (from the top-level of the
# pkgsrc tree), and use the values of the definitions
# SITE_SPECIFIC_PKGS, HOST_SPECIFIC_PKGS, GROUP_SPECIFIC_PKGS, and
# USER_SPECIFIC_PKGS.
# Possible: defined, not defined
# Default: not defined

#SITE_SPECIFIC_PKGS=
# List of packages that are wanted for each host on the site.  Each
# package in the list is of the form <category>/<package>.
# Possible: any combination of packages
# Default: not set

#HOST_SPECIFIC_PKGS=
# List of packages that are wanted for this particular host/machine. 
# Each package in the list is of the form <category>/<package>.
# Possible: any combination of packages
# Default: not set

#GROUP_SPECIFIC_PKGS=
# List of packages that are wanted for this group of users.  Each
# package in the list is of the form <category>/<package>.
# Possible: any combination of packages
# Default: not set

#USER_SPECIFIC_PKGS=
# List of packages that are wanted for this particular user.  Each
# package in the list is of the form <category>/<package>.
# Possible: any combination of packages
# Default: not set

#EXTRACT_USING_PAX=
# Use pax(1) to extract archives, rather than GNU tar.
# Possible: defined, not defined
# Default: not defined

#FAILOVER_FETCH=
# Perform a checksum at "make fetch" time.  If the checksum doesn't
# match the stored value, try to retrieve the file from the next site
# in the list
# Possible:  defined, not defined
# Default: not defined

#MASTER_SORT=        .ac.at .at .de .ch .se .fi .no
# Whitespace delimited list of preferred download locations. 
# MASTER_SITES will be reordered according to the hosts' address last
# components.
# Possible: list of domain name suffixes
# Default: none

#MASTER_SORT_REGEX=  ftp://.*/ 
# Same as MASTER_SORT, but takes a regular expression for more
# flexibility in matching.  Regexps defined here have higher priority
# than MASTER_SORT.  This example would prefer ftp transfers over
# anything else.
# Possible: Regexps as in awk(1)
# Default: none

#PATCH_DEBUG=
# Used to debug patches as they are applied
# Possible: defined, not defined
# Default: not defined

#PRE_ROOT_CMD=${CHMOD} -R o+w ${WRKDIR}
# Command to be run by normal user, just before becoming root (see
# SU_CMD) to install the package.  For example, the command shown
# would allow root to write and modify files below ${WRKDIR}, if on an
# NFS -noroot file system.
# Possible: any shell commands
# Default: none

#SU_CMD=${SU} - root -c
# Command to perform before "make install", if the user does not have
# an effective uid of 0.  A possible substitute is "sudo -u root"
# Possible: su, sudo, or priv, with appropriate arguments
# Default: ${SU} - root -c

#
#	Definitions used only in the packages collection
#

#AMANDA_USER=	backup
# Used in the amanda packages to specify the login user and group
# responsible for backups
# Possible: any user name
# Default: backup

#AMANDA_SMB=
# Used in the amanda-client package to enable backup with smbclient
# Possible: defined, not defined
# Default: not defined

#AMANDA_VAR=	/var/amanda
# Specifies the directory in which amanda puts its logs and status
# files. 
# Default: /var/amanda

#APACHE_PERF_TUNING=	YES
# Optimize for maximum Apache performance.
# Possible: not defined, YES
# Default: not defined

#APACHE_SUEXEC=	YES
# Enable support Switch User For Exec.  See
# http://www.apache.org/docs/suexec.html for more informations.
# Possible: not defined, YES
# Default: not defined

#BOOTSTRAP_EGCS=
# Used in egcs-current package to set bootstrap compile (two-stage)
# mode.
# Possible: defined, not defined
# Default: not defined

#DEFAULT_IRC_SERVER=
# Used in ircII to set the default irc server. 
# Possible: see the list at
# http://www.irchelp.org/irchelp/networks/servers/efnet.html
# Default: not defined

#DT_LAYOUT=
# Used by dt package to specify the keyboard layout.
# Possible: US, FI, FR, GER, DV
# Default: FI

#GLX_CHIPSET=
# Used to select chipset to build "Mesa-glx" package for.  Either
# Matrox MGA 200/400 or Riva TNT/TNT 2 can be supported.
# Possible: mga, tnt
# Default: mga

#IRRD_USE_PGP=
# Used by irrd package to specify the version of PGP to use, if any.
# Possible: 5, 2, not defined
# Default: not defined
# [XXX: configure will locate pgpv or pgp]

#ISPELL_EXTRA_DICT=
# Used by ispell package to specify an extra national dictionary.
# Possible: [agc - unknown]
# Default: not defined

#INN_DATA_DIR=
# Used by inn to specify the data directory.
# Possible: any path you like
# Default: /var/news

#ISPELL_FR=
# Used by ispell to specify a French/English
# dictionary.
# Possible: defined, not defined
# Default: not defined

#ISPELL_LANG=
# Used by ispell to specify national dictionary
# Possible: not defined, british
# Default: not defined

#JB_PACKAGE= test
# Used by jitterbug to determine the type of package to be installed.
# Possible: test, production
# Default: test

#JB_USER=jitter
# Used by jitterbug package for username
# Possible: any valid username
# Default: jitter

#JB_USERID=509
# Used by jitterbug package for uid of JB_USER.
# Possible: any valid uid
# Default: 509

#JB_GROUP=jitter
# Used by jitterbug package for groupname
# Possible: any valid groupname
# Default: jitter

#JB_GROUPID=509
# Used by jitterbug package for gid of JB_USER.
# Possible: any valid gid
# Default: 509

#JB_FQHOSTNAME=
# Used by jitterbug package to include the fully-qualified domain name
# of the host.
# Possible: defined, not defined
# default: not defined

#JB_LOCALMAIL=
# Used by jitterbug package as the mail alias to receive mail from
# jitterbug
# Possible: any valid mail alias
# default: none

#KERBEROS=
# Used in many packages to specify use of a Kerberos (or compatible)
# subsystem.  Requires Kerberos libraries in /usr/lib.
# Possible: 4, 5, not defined
# Default: not defined

#KNEWS_DOMAIN_FILE=
# Used in the knews package to set the domain name from the contents
# of this file.
# Possible: any valid path
# Default: none

#KNEWS_DOMAIN_NAME=
# Used in the knews package to set the domain name.
# Possible:  almost anything really, usually a FQDN.
# Default: none

#KTERM_USE_WALLPAPER=
# Used in kterm package to support wallpaper
# Possible: not defined, YES
# Default: not defined

#LAME_USE_GTK=		YES
# The audio/lame mpeg audio encoder should build with the GTK+ GUI.
# Possible: YES, or NO.
# Default: YES

#LIBWRAP_FWD=
# Used in ssh package to make libwrap also compare against forwarded
# connection attempts
# Possible: not defined, YES
# Default: not defined

#LPRNG_SUID=		YES
# Used by LPRng to enable setuid installation of LPRng binaries.
# Possible: YES, or NO.
# Default: YES 

#LPRNG_PRIV_PORTS=	NO
# Used by LPRng to require connections to be from privileged ports.
# Possible: YES, or NO.
# Default: NO

#M68060=
# Used mostly by packages (e.g.:  pgp2, ssh) with have fast
# 68020/030/040 assembler routines for multiprecision arithmetic,
# which use the 32/64bit mul/div instruction.  These instructions are
# software emulated on the 68060, thus very slow.  Set to YES when
# compiling for the 68060 cpu.
# Possible: not defined, YES.
# Default: not defined.

#MAJORDOMO_USER=
# Used by majordomo package as the userid majordomo runs at.
# Possible: any
# Default: majordom

#MAJORDOMO_GROUP=
# Used by the majordomo package as the groupid majordomo runs at.
# Possible: any
# Default: majordom

#MAJORDOMO_TMPDIR=
# Used by the majordomo package as the directory to store temp files.
# Possible: any directory.
# Default: /var/tmp

#MUTT_INTERNATIONAL=	YES
# Used to decide if international export restricted version of "mutt"
# is built.
# Possible: not defined, YES
# Default: not defined

#NMH_EDITOR=
# default editor for use in nmh.
# Possible: any editor.
# Default: vi

#NMH_MTA=	smtp
# default MTA for use in nmh.
# Possible: smtp or sendmail.
# Default: smtp

#NMH_PAGER=
# default pager for use in nmh.
# Possible: any editor.
# Default: more

#NS_ENCRYPTION=	us
# Used to decide if export or US version of Netscape should be
# installed.
# Possible: export, us
# Default: export

PAPERSIZE=	A4
# Default paper size for packages.
# Possible: A4, Letter, Letterdj.
# Default: none

#PGGROUP=ingres
# Used in postgresql package as the groupname of the database
# administrator
# Possible: any group name
# Default: ingres

#PGUSER=pgsql
# Used in postgresql package as the username of the database admin
# Possible: any user name
# Default: pgsql

#PGSQL_USE_TCL=
# Used in postgresql package to enable building the Tcl/Tk interface.
# Possible: YES, NO
# Default: YES

#QPOPPER_SERVERMODE=
# Used in qpopper package to enable server mode.
# Possible: defined, not defined
# Default: not defined

#RCS_LOCALID=
# Used in cvs-current package for an RCS Id which is expanded.
# Possible: anything (within reason)
# Default: none

#SSH_CONF_DIR=
# Used in ssh to set the configuration directory.
# Possible: any valid directory
# Default: /etc

#SSH_DONT_USE_IDEA=
# Used in ssh package to stop IDEA encryption
# Possible: defined, not defined
# Default: not defined

#SSH_SUID=
# Used in ssh to enable setuid installation of "ssh" binary.
# Possible: YES, or NO.
# Default: NO

#USE_CANNA=
# Used in kinput2 and nvi-m17n to enable Canna kana-kanji converter
# support.
# Possible: YES, or NO.
# Default: YES

#USE_GIF=
# Enable GIF support in qt.  (disabled per default due to licensing
# problems; future revisions might have no support at all)
# Possible: defined, not defined
# Default: not defined

#USE_INET6=
# Enable IPv6 support on certain packages.  Use IPv6-ready kernel if
# you define this.
# Possible: not defined, YES
# Default: not defined

#USE_INN=
# Used in trn and nn to specify use of "inn" instead of "nntpclnt"
# package to provide "inews" binary.
# Possible: not defined, YES
# Default: not defined

#USE_RSAREF2=	NO
# Use the RSA reference package
# Possible: YES (US domestic only), or NO.
# Default: not defined.

#USE_SJ3=
# Used in kinput2 to enable SJ3 kana-kanji converter support.
# Possible: YES, or NO.
# Default: YES

#USE_SOCKS=
# Used to specify SOCKS firewall support Set this to the version of
# socks necessary.
# Possible: 4, 5, not defined
# Default: not defined

#USE_WNN4=
# Used in kinput2 to enable FreeWnn (a.k.a.  Wnn4) kana-kanji
# converter support.
# Possible: YES, or NO.
# Default: YES

#USE_XFACE=
# Used in xemacs package to build in support for xface
# (pkgsrc/mail/face)
# Possible: not defined, YES
# Default: not defined

#WINDOWMAKER_OPTIONS=
# Options for building windowmaker package Used to add support for
# GNOME, KDE or OPEN LOOK(tm) and to avoid redundancies with KDE.
# Possible: gnome, kde, openlook, lite
# Default: gnome kde

#WINDOWMAKER_THEMES=	...
# Used in wm-themes package to specify the themes which will be
# installed.
# Possible: see http://wm.themes.org/
# Default: FreeBSD-theme

#XAW_TYPE=standard
# Used in various packages to specify that libXaw is used.
# Possible: standard, 3d, xpm
# Default: standard

#ZIP_ENCRYPTION=
# Add encryption code to zip, zip1, and unzip
# Possible: defined, not defined
# Default: not defined

#
#	Overrides for faster or cheaper sites.
#
#	Refer to http://www.netbsd.org/Sites/net.html or /usr/doc/MIRRORS
#	for information on determining the location of NetBSD mirror sites.
#

# Australia (AARNET).  Swap order of ftp.au.netbsd.org and
# ftp2.au.netbsd.org if your link to University of Queensland is
# cheaper/faster than your link to RMIT University (Melbourne).
#
#MASTER_SITE_XCONTRIB=	ftp://mirror.aarnet.edu.au/X11/contrib/
#MASTER_SITE_GNU=	ftp://mirror.aarnet.edu.au/gnu/
#MASTER_SITE_PERL_CPAN=	ftp://mirror.aarnet.edu.au/perl/CPAN/modules/by-module/
#MASTER_SITE_TEX_CTAN=	ftp://mirror.aarnet.edu.au/tex-archive/
#MASTER_SITE_SUNSITE=	ftp://mirror.aarnet.edu.au/sunsite.unc.edu/
#MASTER_SITE_BACKUP=	\
#	ftp://ftp.au.netbsd.org/pub/NetBSD/packages/distfiles/${DIST_SUBDIR}/ \
#	ftp://ftp2.au.netbsd.org/pub/NetBSD/packages/distfiles/${DIST_SUBDIR}/
#MASTER_SITE_LOCAL=	\
#	ftp://ftp.au.netbsd.org/pub/NetBSD/packages/distfiles/LOCAL_PORTS/ \
#	ftp://ftp2.au.netbsd.org/pub/NetBSD/packages/distfiles/LOCAL_PORTS/

# Finland
#
#MASTER_SITE_XCONTRIB=	ftp://ftp.funet.fi/pub/X11/contrib/
#MASTER_SITE_GNU= 	ftp://ftp.funet.fi/pub/gnu/gnu/
#MASTER_SITE_PERL_CPAN=	\
#	ftp://ftp.funet.fi/pub/languages/perl/CPAN/modules/by-module/
#MASTER_SITE_TEX_CTAN=	ftp://ftp.funet.fi/pub/TeX/CTAN/
#MASTER_SITE_SUNSITE=	\
#	ftp://ftp.funet.fi/pub/mirrors/sunsite.unc.edu/pub/Linux/
#MASTER_SITE_BACKUP=	\
#	ftp://ftp.fi.netbsd.org/pub/NetBSD/packages/distfiles/${DIST_SUBDIR}/
#MASTER_SITE_LOCAL=	\
#	ftp://ftp.fi.netbsd.org/pub/NetBSD/packages/distfiles/LOCAL_PORTS/

# Austria
#
#MASTER_SITE_XCONTRIB=	ftp://ftp.at.netbsd.org/hci/X11/contrib/
#MASTER_SITE_GNU=	ftp://ftp.at.netbsd.org/gnu/gnusrc/
#MASTER_SITE_PERL_CPAN=	ftp://ftp.at.netbsd.org/languages/perl/CPAN/modules/by-module/
#MASTER_SITE_TEX_CTAN=	ftp://ftp.at.netbsd.org/publishing/tex/CTAN/
#MASTER_SITE_SUNSITE=	ftp://ftp.univie.ac.at/systems/linux/sunsite/
#MASTER_SITE_BACKUP=	ftp://ftp.at.netbsd.org/opsys/NetBSD/packages/distfiles/${DIST_SUBDIR}/
#MASTER_SITE_LOCAL=	ftp://ftp.at.netbsd.org/opsys/NetBSD/packages/distfiles/LOCAL_PORTS/

# Denmark
#
#MASTER_SITE_XCONTRIB=	ftp://ftp.sunsite.auc.dk/mirrors/ftp.x.org/contrib/
#MASTER_SITE_GNU=	ftp://ftp.sunsite.auc.dk/pub/gnu/
#MASTER_SITE_PERL_CPAN=	ftp://ftp.sunsite.auc.dk/pub/languages/perl/CPAN/modules/by-module/
#MASTER_SITE_TEX_CTAN=	ftp://ftp.sunsite.auc.dk/pub/tex/ctan/
#MASTER_SITE_SUNSITE=	ftp://ftp.sunsite.auc.dk/mirrors/sunsite.unc.edu/pub/Linux/

# Japan
#
#MASTER_SITE_XCONTRIB=	ftp://ftp.ring.gr.jp/pub/X/opengroup/contrib/
#MASTER_SITE_GNU=	ftp://ftp.ring.gr.jp/pub/GNU/
#MASTER_SITE_PERL_CPAN=	ftp://ftp.ring.gr.jp/pub/lang/perl/CPAN/modules/by-module/
#MASTER_SITE_TEX_CTAN=	ftp://ftp.ring.gr.jp/pub/text/CTAN/
#MASTER_SITE_SUNSITE=	ftp://sunsite.sut.ac.jp/pub/archives/linux/
#MASTER_SITE_BACKUP=	\
#	ftp://ftp.ring.gr.jp/pub/NetBSD/packages/distfiles/${DIST_SUBDIR}/ \
#	ftp://ftp.jp.netbsd.org/pub/NetBSD/packages/distfiles/${DIST_SUBDIR}/
#MASTER_SITE_LOCAL=	\
#	ftp://ftp.ring.gr.jp/pub/NetBSD/packages/distfiles/LOCAL_PORTS/ \
#	ftp://ftp.jp.netbsd.org/pub/NetBSD/packages/distfiles/LOCAL_PORTS/