mdoc(7) police:

Use proper macros for variables and their types, removed
hard sentence breaks, added a bunch of cross references.

1 files changed, 508 insertions, 279 deletions

diff --git a/share/man/man5/make.conf.5 b/share/man/man5/make.conf.5
index 651a467..7f74526 100644
--- a/share/man/man5/make.conf.5
+++ b/share/man/man5/make.conf.5
@@ -29,12 +29,15 @@
 .Os
 .Sh NAME
 .Nm make.conf
-.Nd system build information.
+.Nd system build information
 .Sh DESCRIPTION
 The file
 .Nm
-contains settings that control the compilation of the FreeBSD sources
-and ported applications. The file 
+contains settings that control the compilation of the
+.Fx
+sources
+and ported applications.
+The file
 .Nm
 is generally created by the system administrator when the values need
 to be changed from their defaults.
@@ -42,9 +45,10 @@ to be changed from their defaults.
 The purpose of
 .Nm
 is not to run commands or perform compilation actions
-directly.  Instead, it is included by the
+directly.
+Instead, it is included by the
 various makefiles in
-.Pa /usr/src,
+.Pa /usr/src ,
 .Pa /usr/ports
 and
 .Pa /usr/doc
@@ -53,149 +57,211 @@ internal actions according to the settings found there.
 .Pp
 The
 .Pa /etc/make.conf
-file is included from the the appropriate Makefile
+file is included from the the appropriate
+.Pa Makefile
 which specifies the default settings for all the available options.
-Options need only be specified in 
+Options need only be specified in
 .Pa /etc/make.conf
 when the system administrator wishes to override these defaults.
 .Pp
 The build procedures occur in four broad areas: the world, the kernel,
-documentations and ports. Variables set in
+documentations and ports.
+Variables set in
 .Nm
 may be applicable during builds in one, two, or all four of these
-areas. They may be specified for a particular build via the
-.Op -D
+areas.
+They may be specified for a particular build via the
+.Fl D
 option of
 .Xr make 1 .
 .Pp
-The following lists provides a name and short description for each
-variable you can use during the indicated builds. The values of
+The following lists provide a name and short description for each
+variable you can use during the indicated builds.
+The values of
 variables flagged as
-bool
+.Vt bool
 are ignored; the variable being
 set at all (even to 
-.Li Dq FALSE
+.Dq Li FALSE
 or
-.Li Dq NO )
+.Dq Li NO )
 cause it to
 be treated as if it were set.
 .Pp
 The following list provides a name and short description for variables
 that are used for all builds, or are used by the
-makefiles for things other than builds.
+.Pa makefiles
+for things other than builds.
 .Bl -tag -width Ar
-.It Ar CFLAGS
-(str) Controls the compiler setting when compiling C code.
+.It Va CFLAGS
+.Vt ( str )
+Controls the compiler setting when compiling C code.
 Optimization levels above
-.Op -O ( -O2 , ...\& )
-are not supported. BDECFLAGS
-is provided as a set of gcc settings suggested by Bruce Evans
-for developing and testing changes. They can be used by:
+.Oo Fl O ( O2 , No ...\& ) Oc
+are not supported.
+.Va BDECFLAGS
+is provided as a set of
+.Xr gcc 1
+settings suggested by
+.An "Bruce Evans" Aq bde@FreeBSD.org
+for developing and testing changes.
+They can be used by:
+.Pp
 .Bd -literal -offset indent
 CXFLAGS+=${BDECFLAGS}
 .Ed
-.It Ar CVS_UPDATE
-(bool) Set this to use cvs to update your ports with
-.Cm "make update" .
-.It Ar CXXFLAGS
-(str) Controls the compiler settings when compiling C++ code.
-CXXFLAGS is initially set to the value of CFLAGS. If you want to
-add to the CXXFLAGS value, use 
+.It Va CVS_UPDATE
+.Vt ( bool )
+Set this to use
+.Xr cvs 1
+to update your ports with
+.Dq Li "make update" .
+.It Va CXXFLAGS
+.Vt ( str )
+Controls the compiler settings when compiling C++ code.
+.Va CXXFLAGS
+is initially set to the value of
+.Va CFLAGS .
+If you want to
+add to the
+.Va CXXFLAGS
+value, use
 .Dq Li +=
 instead of
 .Dq Li = .
-.It Ar INSTALL
-(str) the default install command. To have commands compared before doing
+.It Va INSTALL
+.Vt ( str )
+the default install command.
+To have commands compared before doing
 the install, use
 .Bd -literal -offset indent
 INSTALL="install -C"
 .Ed
-.It Ar LOCAL_DIRS
-(str) List any directories that should be entered when doing
+.It Va LOCAL_DIRS
+.Vt ( str )
+List any directories that should be entered when doing
 make's in
-.Pa /usr/src 
+.Pa /usr/src
 in this variable.
-.It Ar MTREE_FOLLOWS_SYMLINKS
-(str) Set this to
-.Dq Li -L
-to cause mtree to follow symlinks.
-.It Ar NO_DOCUPDATE
-(bool) Set this to not update the doc tree during
-.Cm "make update" .
-.It Ar NO_PORTSUPDATE
-(bool) Set this to not update the ports tree during
-.Cm "make update" .
-.It Ar SUP_UPDATE
-(bool) Set this to use cvsup to update your ports with
-.Cm "make update" .
-.It Ar SUP
-(str) The location of the cvsup command for
-.Cm "make update" .
-.It Ar SUPFLAGS
-(str) The flag for the sup command when doing
-.Cm "make update" .
-This defaults to 
-.Op "-g -L 2" .
-.It Ar SUPHOST
-(str) The hostname of the sup server to use when doing
-.Cm "make update" .
-.It Ar SUPFILE
-(str) The first supfile to use when doing a
-.Cm "make update" .
+.It Va MTREE_FOLLOWS_SYMLINKS
+.Vt ( str )
+Set this to
+.Dq Fl L
+to cause
+.Xr mtree 8
+to follow symlinks.
+.It Va NO_DOCUPDATE
+.Vt ( bool )
+Set this to not update the doc tree during
+.Dq Li "make update" .
+.It Va NO_PORTSUPDATE
+.Vt ( bool )
+Set this to not update the ports tree during
+.Dq Li "make update" .
+.It Va SUP_UPDATE
+.Vt ( bool )
+Set this to use
+.Xr cvsup 1
+to update your ports with
+.Dq Li "make update" .
+.It Va SUP
+.Vt ( str )
+The location of the
+.Xr cvsup 1
+command for
+.Dq Li "make update" .
+.It Va SUPFLAGS
+.Vt ( str )
+The flag for the
+.Xr sup 1
+command when doing
+.Dq Li "make update" .
 This defaults to
-.Pa /usr/share/examples/cvsup/standard-supfile .
-.It Ar SUPFILE1
-(str) The second supfile to use when doing a
-.Cm "make update" .
+.Op Fl g L Ar 2 .
+.It Va SUPHOST
+.Vt ( str )
+The hostname of the sup server to use when doing
+.Dq Li "make update" .
+.It Va SUPFILE
+.Vt ( str )
+The first
+.Ar supfile
+to use when doing a
+.Dq Li "make update" .
 This defaults to
-.Pa /usr/share/examples/cvsup/secure-supfile .
-.It Ar SUPFILE2
-(str) The third supfile to use when doing a
-.Cm "make update" .
+.Pa /usr/share/examples/cvsup/standard\-supfile .
+.It Va SUPFILE1
+.Vt ( str )
+The second
+.Ar supfile
+to use when doing a
+.Dq Li "make update" .
 This defaults to
-.Pa /usr/share/examples/cvsup/secure-supfile .
-.It Ar PORTSSUPFILE
-(str) The ports supfile to use when doing a
-.Cm "make update" .
+.Pa /usr/share/examples/cvsup/secure\-supfile .
+.It Va SUPFILE2
+.Vt ( str )
+The third
+.Ar supfile
+to use when doing a
+.Dq Li "make update" .
 This defaults to
-.Pa /usr/share/examples/cvsup/ports-supfile .
-.It Ar DOCSUPFILE
-(str) The documentation supfile to use when doing a
-.Cm "make update" .
+.Pa /usr/share/examples/cvsup/secure\-supfile .
+.It Va PORTSSUPFILE
+.Vt ( str )
+The ports
+.Ar supfile
+to use when doing a
+.Dq Li "make update" .
 This defaults to
-.Pa /usr/share/examples/cvsup/doc-supfile .
+.Pa /usr/share/examples/cvsup/ports\-supfile .
+.It Va DOCSUPFILE
+.Vt ( str )
+The documentation
+.Ar supfile
+to use when doing a
+.Dq Li "make update" .
+This defaults to
+.Pa /usr/share/examples/cvsup/doc\-supfile .
 .El
 .Pp
 The following list provides a name and short description for variables
 that are only used doing a kernel build:
 .Bl -tag -width Ar
-.It Ar BOOT_COMCONSOLE_PORT
-(str) The port address to use for the console if the boot blocks have
+.It Va BOOT_COMCONSOLE_PORT
+.Vt ( str )
+The port address to use for the console if the boot blocks have
 been configured to use a serial console instead of the keyboard/video card.
-.It Ar BOOT_COMCONSOLE_SPEED
-(int) The baud rate to use for the console if the boot blocks have
+.It Va BOOT_COMCONSOLE_SPEED
+.Vt ( int )
+The baud rate to use for the console if the boot blocks have
 been configured to use a serial console instead of the keyboard/video card.
-.It Ar BOOTWAIT
-(int) Controls the amount of time the kernel waits for a console keypress
-before booting the default kernel. The value is approximately
-milliseconds. Keypresses are accepted by the BIOS before booting from disk,
+.It Va BOOTWAIT
+.Vt ( int )
+Controls the amount of time the kernel waits for a console keypress
+before booting the default kernel.
+The value is approximately milliseconds.
+Keypresses are accepted by the BIOS before booting from disk,
 making it possible to give custom boot parameters even when this is
 set to 0.
-.It Ar COPTFLAGS
-(str) Controls the compiler settings when building the
-kernel. Optimization levels above
-.Op -O ( -O2 , ...\& )
+.It Va COPTFLAGS
+.Vt ( str )
+Controls the compiler settings when building the
+kernel.
+Optimization levels above
+.Oo Fl O ( O2 , No ...\& ) Oc
 are not supported.
-.It Ar KERNEL
-(str) Controls which kernel configurations will be
+.It Va KERNEL
+.Vt ( str )
+Controls which kernel configurations will be
 built by
-.Cm  "${MAKE} buildkernel"
-and installed by 
-.Cm "${MAKE} installkernel" .
+.Dq Li "${MAKE} buildkernel"
+and installed by
+.Dq Li "${MAKE} installkernel" .
 For example,
 .Bd -literal -offset indent
 KERNEL=MINE DEBUG GENERIC OTHERMACHINE
 .Ed
+.Pp
 will build the the kernels specified by the config files
 .Pa MINE , DEBUG , GENERIC ,
 and
@@ -204,151 +270,251 @@ and install the kernel specified by the config file
 .Pa MINE .
 It defaults to
 .Pa GENERIC .
-.It Ar NO_KERNELCONFIG
-(bool) Set this to skip running
+.It Va NO_KERNELCONFIG
+.Vt ( bool )
+Set this to skip running
 .Xr config 8
 during
-.Cm "${MAKE} buildkernel" .
-.It Ar NO_KERNELDEPEND
-(bool) Set this to skip running 
-.Cm "${MAKE} depend"
+.Dq Li "${MAKE} buildkernel" .
+.It Va NO_KERNELDEPEND
+.Vt ( bool )
+Set this to skip running
+.Dq Li "${MAKE} depend"
 during
-.Cm "${MAKE} buildkernel" .
-.It Ar NO_MODULES
-(bool) Set to  not build modules with the kernel.
+.Dq Li "${MAKE} buildkernel" .
+.It Va NO_MODULES
+.Vt ( bool )
+Set to not build modules with the kernel.
 .El
 .Pp
 The following list provides a name and short description for variables
 that are used during the world build:
 .Bl -tag -width Ar
-.It Ar COMPAT1X
-(bool) Set to install the 
+.It Va COMPAT1X
+.Vt ( bool )
+Set to install the
 .Fx
 1 compatibility libraries.
-.It Ar COMPAT20
-(bool) Set to install the
+.It Va COMPAT20
+.Vt ( bool )
+Set to install the
 .Fx 2.0
 compatibility libraries.
-.It Ar COMPAT21
-(bool) Set to install the
+.It Va COMPAT21
+.Vt ( bool )
+Set to install the
 .Fx 2.1
 compatibility libraries.
-.It Ar COMPAT22
-(bool) Set to install the
+.It Va COMPAT22
+.Vt ( bool )
+Set to install the
 .Fx 2.2
 compatibility libraries.
-.It Ar COMPAT3X
-(bool) Set to install the
+.It Va COMPAT3X
+.Vt ( bool )
+Set to install the
 .Fx
-3 compatibility libraries.
-.It Ar ENABLE_SUIDPERL
-(bool) Set to enable the installation of an suid perl binary.
-.It Ar FETCH_CMD
-(str) Command to use to fetch files. Normally
+3
+compatibility libraries.
+.It Va ENABLE_SUIDPERL
+.Vt ( bool )
+Set to enable the installation of an suid
+.Xr perl 1
+binary.
+.It Va FETCH_CMD
+.Vt ( str )
+Command to use to fetch files.
+Normally
 .Xr fetch 1 .
-.It Ar MAKE_IDEA
-(bool) Set to build the IDEA encryption code. This code is patented in
-the USA and many european countries. It is 
+.It Va MAKE_IDEA
+.Vt ( bool )
+Set to build the IDEA encryption code.
+This code is patented in the USA and many European countries.
+It is
 .Em "YOUR RESPONSIBILITY"
 to determine if you can legally use IDEA.
-.It Ar MAKE_KERBEROS4
-(bool) Set this to build KerberosIV (KTH eBones).
-.It Ar MAKE_KERBEROS5
-(bool) Set this to build Kerberos5 (KTH Heimdal).
+.It Va MAKE_KERBEROS4
+.Vt ( bool )
+Set this to build KerberosIV (KTH eBones).
+.It Va MAKE_KERBEROS5
+.Vt ( bool )
+Set this to build Kerberos5 (KTH Heimdal).
 .Em WARNING!
-This is still experimental code. If you need stable Kerberos5, use the
+This is still experimental code.
+If you need stable Kerberos5, use the
 port(s).
-.It Ar MODULES_WITH_WORLD
-(bool) Set to build modules with the system instead of the kernel.
-.It Ar NO_CVS
-(bool) Set to not build CVS.
-.It Ar NO_BIND
-(bool) Set to  not build BIND.
-.It Ar NO_FORTRAN
-(bool) Set to  not build g77 and related libraries.
-.It Ar NO_LPR
-(bool) Set to  not build lpr and related programs.
-.It Ar NO_MAILWRAPPER
-(bool) Set to  not build the mailwrapper(8) MTA selector.
-.It Ar NO_MAKEDEV
-(bool) Set to avoid running MAKEDEV all on /dev during install.
-.It Ar NO_OBJC
-(bool) Set to  not build Objective C support.
-.It Ar NO_OPENSSH
-(bool) Set to  not build OpenSSH.
-.It Ar NO_OPENSSL
-(bool) Set to  not build OpenSSL (implies NO_OPENSSH).
-.It Ar NO_SENDMAIL
-(bool) Set to  not build sendmail and related programs.
-.It Ar NO_SHAREDOCS
-(bool) Set to  not build the 4.4BSD legacy docs.
-.It Ar NO_TCSH
-(bool) Set to  not build and install /bin/csh (which is tcsh).
-.It Ar NO_X
-(bool) Set to  not compile in XWindows support (e.g. doscmd).
-.It Ar NOCLEAN
-(bool) Set this to disable cleaning during
-.Cm "make buildworld" .
+.It Va MODULES_WITH_WORLD
+.Vt ( bool )
+Set to build modules with the system instead of the kernel.
+.It Va NO_CVS
+.Vt ( bool )
+Set to not build CVS.
+.It Va NO_BIND
+.Vt ( bool )
+Set to not build BIND.
+.It Va NO_FORTRAN
+.Vt ( bool )
+Set to not build
+.Xr g77 1
+and related libraries.
+.It Va NO_LPR
+.Vt ( bool )
+Set to not build
+.Xr lpr 1
+and related programs.
+.It Va NO_MAILWRAPPER
+.Vt ( bool )
+Set to not build the
+.Xr mailwrapper 8
+MTA selector.
+.It Va NO_MAKEDEV
+.Vt ( bool )
+Set to avoid running
+.Dq Li "MAKEDEV all"
+on
+.Pa /dev
+during install.
+.It Va NO_OBJC
+.Vt ( bool )
+Set to not build Objective C support.
+.It Va NO_OPENSSH
+.Vt ( bool )
+Set to not build OpenSSH.
+.It Va NO_OPENSSL
+.Vt ( bool )
+Set to not build OpenSSL (implies
+.Va NO_OPENSSH ) .
+.It Va NO_SENDMAIL
+.Vt ( bool )
+Set to not build
+.Xr sendmail 8
+and related programs.
+.It Va NO_SHAREDOCS
+.Vt ( bool )
+Set to not build the
+.Bx 4.4
+legacy docs.
+.It Va NO_TCSH
+.Vt ( bool )
+Set to not build and install
+.Pa /bin/csh
+(which is
+.Xr tcsh 1 ) .
+.It Va NO_X
+.Vt ( bool )
+Set to not compile in X\-Windows support (e.g.\&
+.Xr doscmd 1 ) .
+.It Va NOCLEAN
+.Vt ( bool )
+Set this to disable cleaning during
+.Dq Li "make buildworld" .
 This should not be set unless you know what you are doing.
-.It Ar NOCLEANDIR
-(bool) Set this to run
-.Cm "${MAKE} clean"
+.It Va NOCLEANDIR
+.Vt ( bool )
+Set this to run
+.Dq Li "${MAKE} clean"
 instead of
-.Cm "${MAKE} cleandir" .
-.It Ar NOCRYPT
-(bool) Set to not build any crypto code.
-.It Ar NOGAMES
-(bool) Set to not build games.
-.It Ar NOINFO
-(bool) Set to not make or install info files.
-.It Ar NOLIBC_R
-(bool) Set to not build libc_r (re-entrant version of libc).
-.It Ar NOMANCOMPRESS
-(bool) Set to install man pages uncompressed.
-.It Ar NOPERL
-(bool) Set to avoid building perl.
-.It Ar NOPROFILE
-(bool) Set to avoid compiling profiled libraries.
-.It Ar NOSECURE
-(bool) set to not build crypto code in secure subdir.
-.It Ar NOSHARE
-(bool) Set to not build in the share subdir.
-.It Ar NOUUCP
-(bool) Set to not build uucp related programs.
-.It Ar PERL_THREADED
-(bool) Set to enable the building and installation of perl with thread
+.Dq Li "${MAKE} cleandir" .
+.It Va NOCRYPT
+.Vt ( bool )
+Set to not build any crypto code.
+.It Va NOGAMES
+.Vt ( bool )
+Set to not build games.
+.It Va NOINFO
+.Vt ( bool )
+Set to not make or install
+.Xr info 5
+files.
+.It Va NOLIBC_R
+.Vt ( bool )
+Set to not build
+.Nm libc_r
+(reentrant version of
+.Nm libc ) .
+.It Va NOMANCOMPRESS
+.Vt ( bool )
+Set to install man pages uncompressed.
+.It Va NOPERL
+.Vt ( bool )
+Set to avoid building
+.Xr perl 1 .
+.It Va NOPROFILE
+.Vt ( bool )
+Set to avoid compiling profiled libraries.
+.It Va NOSECURE
+.Vt ( bool )
+set to not build crypto code in
+.Pa secure
+subdir.
+.It Va NOSHARE
+.Vt ( bool )
+Set to not build in the
+.Pa share
+subdir.
+.It Va NOUUCP
+.Vt ( bool )
+Set to not build
+.Xr uucp 1
+related programs.
+.It Va PERL_THREADED
+.Vt ( bool )
+Set to enable the building and installation of
+.Xr perl 1
+with thread
 support.
-.It Ar PPP_NOSUID
-(bool) Set to disable the installation of ppp as an suid root program.
-.It Ar SENDMAIL_CFLAGS
-(str) Flags to pass to the compile command when building sendmail. The
-sendmail flags can be used to provide SASL support with setting such as:
+.It Va PPP_NOSUID
+.Vt ( bool )
+Set to disable the installation of
+.Xr ppp 8
+as an suid root program.
+.It Va SENDMAIL_CFLAGS
+.Vt ( str )
+Flags to pass to the compile command when building
+.Xr sendmail 8 .
+The
+.Va SENDMAIL_*
+flags can be used to provide SASL support with setting such as:
 .Bd -literal -offset indent
 SENDMAIL_CFLAGS=-I/usr/local/include -DSASL
 SENDMAIL_LDFLAGS=-L/usr/local/lib
 SENDMAIL_LDADD=-lsasl
 .Ed
-.It Ar SENDMAIL_LDFLAGS
-(str) Flags to pass to the ld command when building sendmail.
-.It Ar SENDMAIL_LDADD
-(str) Flags to add to the end of the ld command when building sendmail.
-.It Ar SENDMAIL_DPADD
-(str) This variable is undocumented.
+.It Va SENDMAIL_LDFLAGS
+.Vt ( str )
+Flags to pass to the
+.Xr ld 1
+command when building
+.Xr sendmail 8 .
+.It Va SENDMAIL_LDADD
+.Vt ( str )
+Flags to add to the end of the
+.Xr ld 1
+command when building
+.Xr sendmail 8 .
+.It Va SENDMAIL_DPADD
+.Vt ( str )
+This variable is undocumented.
 .El
 .Pp
 The following list provides a name and short description for variables
 that are used when building documentation.
 .Bl -tag -width Ar
-.It Ar DISTDIR
-(str) Where distfiles are kept. Normally, this is
+.It Va DISTDIR
+.Vt ( str )
+Where distfiles are kept.
+Normally, this is
 .Pa distfiles
 in
-.Ev PORTSDIR .
-.It Ar DOC_LANG
-(str) The list of languages and encodings to build and install.
-.It Ar PRINTERDEVICE
-(str) The default format for system documentation, depends on your
-printer. This can be set to 
+.Va PORTSDIR .
+.It Va DOC_LANG
+.Vt ( str )
+The list of languages and encodings to build and install.
+.It Va PRINTERDEVICE
+.Vt ( str )
+The default format for system documentation, depends on your
+printer.
+This can be set to
 .Dq Li ascii
 for simple printers or
 .Dq Li ps
@@ -359,139 +525,200 @@ filter.
 The following list provides a name and short description for variables
 that are used when building ports:
 .Bl -tag -width Ar
-.It Ar FORCE_PKG_RESIDENT
-(bool) Set this to override any existing package registration.
-.It Ar HAVE_MOTIF
-(bool) Set this if you have Motif on your system.
-.It Ar KRB5_HOME
-(str) Set this if you want to install the MIT Kerberos5 port somewhere
+.It Va FORCE_PKG_RESIDENT
+.Vt ( bool )
+Set this to override any existing package registration.
+.It Va HAVE_MOTIF
+.Vt ( bool )
+Set this if you have Motif on your system.
+.It Va KRB5_HOME
+.Vt ( str )
+Set this if you want to install the MIT Kerberos5 port somewhere
 other than
 .Pa /usr/local .
-.It Ar LOCALBASE
-(str) Set this to the base directory that non-X ports should be
-installed in. It provides the default for PREFIX when building in
+.It Va LOCALBASE
+.Vt ( str )
+Set this to the base directory that non\-X ports should be
+installed in.
+It provides the default for
+.Va PREFIX
+when building in
 .Pa /usr/ports .
-.It Ar MASTER_SITE_AFTERSTEP
-(str) Set this to change the master site for AfterStep ports. The last
+.It Va MASTER_SITE_AFTERSTEP
+.Vt ( str )
+Set this to change the master site for AfterStep ports.
+The last
 part of the path must be
 .Dq Li /%SUBDIR%/ .
-.It Ar MASTER_SITE_BACKUP
-(str) Controls the site location that ports check for distfiles if the
-locations listed in their 
+.It Va MASTER_SITE_BACKUP
+.Vt ( str )
+Controls the site location that ports check for distfiles if the
+locations listed in their
 .Pa Makefile
-do not work. The last part of the path must be
+do not work.
+The last part of the path must be
 .Dq Li /${DIST_SUBDIR}/ .
-.It Ar MASTER_SITE_COMP_SOURCES
-(str) Controls the master site location for comp.sources ports. The
+.It Va MASTER_SITE_COMP_SOURCES
+.Vt ( str )
+Controls the master site location for
+.Pa comp.sources
+ports.
+The
 last part of the path must be
 .Dq Li %SUBDIR%/
-.It Ar MASTER_SITE_GNOME
-(str) Controls the master site location for GNOME ports. The
+.It Va MASTER_SITE_GNOME
+.Vt ( str )
+Controls the master site location for GNOME ports.
+The
 last part of the path must be
 .Dq Li /%SUBDIR%/
-.It Ar MASTER_SITE_GNU
-(str) Controls the master site location for GNU ports. The
+.It Va MASTER_SITE_GNU
+.Vt ( str )
+Controls the master site location for GNU ports.
+The
 last part of the path must be
 .Dq Li /%SUBDIR%/
-.It Ar MASTER_SITE_KDE
-(str) Controls the master site location for KDE ports. The
+.It Va MASTER_SITE_KDE
+.Vt ( str )
+Controls the master site location for KDE ports.
+The
 last part of the path must be
 .Dq Li /%SUBDIR%/
-.It Ar MASTER_SITE_FREEBSD
-(bool) If set, go to the master
+.It Va MASTER_SITE_FREEBSD
+.Vt ( bool )
+If set, go to the master
 .Fx
 site for all files.
-.It Ar MASTER_SITE_MOZILLA
-(str) Controls the master site location for Mozilla ports. The
+.It Va MASTER_SITE_MOZILLA
+.Vt ( str )
+Controls the master site location for Mozilla ports.
+The
 last part of the path must be
 .Dq Li /%SUBDIR%/
-.It Ar MASTER_SITE_OVERRIDE
-(str) If set, this site is checked before the sites listed in the ports
+.It Va MASTER_SITE_OVERRIDE
+.Vt ( str )
+If set, this site is checked before the sites listed in the ports
 .Pa Makefile .
 You can have it check the backup site first by like so:
 .Bd -literal -offset indent
 MASTER_SITE_OVERRIDE?=	${MASTER_SITE_BACKUP}
 .Ed
-.It Ar MASTER_SITE_PERL_CPAN
-(str) Controls the master site location for Perl ports. The
+.It Va MASTER_SITE_PERL_CPAN
+.Vt ( str )
+Controls the master site location for Perl ports.
+The
 last part of the path must be
 .Bd -literal -offset indent
 /%SUBDIR%/
 .Ed
-.It Ar MASTER_SORT_REGEX
-(str) Set this to control the sort order for mirror sets. To set it to
-prefer mirrors in the .jp domain, use:
+.It Va MASTER_SORT_REGEX
+.Vt ( str )
+Set this to control the sort order for mirror sets.
+To set it to
+prefer mirrors in the
+.Pa .jp
+domain, use:
 .Bd -literal -offset indent
 MASTER_SORT_REGEX?=	^file: ^ftp://ftp\.FreeBSD\.org/pub/FreeBSD/ports/local-distfiles/ ://[^/]*\.jp/ ://[^/]*\.jp\.
 .Ed
-Users of other ccTLD domins should change the 
+.Pp
+Users of other ccTLD domains should change the
 .Dq Li jp
 to the
 appropriate domain.
-.It Ar MASTER_SITE_RINGSERVER
-(str) Controls the master site location for Ringserver ports. The last
+.It Va MASTER_SITE_RINGSERVER
+.Vt ( str )
+Controls the master site location for Ringserver ports.
+The last
 part of the path must be
 .Dq Li /%SUBDIR%/ .
-.It Ar MASTER_SITE_RUBY
-(str) Controls the master site location for Ruby ports. The last
+.It Va MASTER_SITE_RUBY
+.Vt ( str )
+Controls the master site location for Ruby ports.
+The last
 part of the path must be
 .Dq Li /%SUBDIR%/ .
-.It Ar MASTER_SITE_SUNSITE
-(str) Controls the master site location for Sunsite ports. The last
+.It Va MASTER_SITE_SUNSITE
+.Vt ( str )
+Controls the master site location for Sunsite ports.
+The last
 part of the path must be
 .Dq Li /%SUBDIR%/ .
-.It Ar MASTER_SITE_TCLTK
-(str) Controls the master site location for Tcl and Tk ports. The last
+.It Va MASTER_SITE_TCLTK
+.Vt ( str )
+Controls the master site location for Tcl and Tk ports.
+The last
 part of the path must be
 .Dq Li /%SUBDIR%/ .
-.It Ar MASTER_SITE_TEX_CTAN
-(str) Controls the master site location for TeX ports. The last
+.It Va MASTER_SITE_TEX_CTAN
+.Vt ( str )
+Controls the master site location for TeX ports.
+The last
 part of the path must be
 .Dq Li /%SUBDIR%/ .
-.It Ar MASTER_SITE_WINDOWMAKER
-(str) Controls the master site location for WindowMaker ports. The last
+.It Va MASTER_SITE_WINDOWMAKER
+.Vt ( str )
+Controls the master site location for WindowMaker ports.
+The last
 part of the path must be
 .Dq Li /%SUBDIR%/ .
-.It Ar MASTER_SITE_XCONTRIB
-(str) Controls the master site location for contributed X ports. The last
+.It Va MASTER_SITE_XCONTRIB
+.Vt ( str )
+Controls the master site location for contributed X ports.
+The last
 part of the path must be
 .Dq Li /%SUBDIR%/ .
-.It Ar MASTER_SITE_XEMACS
-(str) Controls the master site location for Xemacs ports. The last
+.It Va MASTER_SITE_XEMACS
+.Vt ( str )
+Controls the master site location for Xemacs ports.
+The last
 part of the path must be
 .Dq Li /%SUBDIR%/ .
-.It Ar MASTER_SITE_XFREE
-(str) Controls the master site location for XFree ports. The last
+.It Va MASTER_SITE_XFREE
+.Vt ( str )
+Controls the master site location for XFree ports.
+The last
 part of the path must be
 .Dq Li /%SUBDIR%/ .
-.It Ar MOTIFLIB
-(str) Location of
+.It Va MOTIFLIB
+.Vt ( str )
+Location of
 .Pa libXm.a
 and
 .Pa libXm.so .
-.It Ar MOTIF_STATIC
-(bool) Set this if you want ports that use Motif to be built so they
+.It Va MOTIF_STATIC
+.Vt ( bool )
+Set this if you want ports that use Motif to be built so they
 can be run on systems without the Motif shared libraries.
-.It Ar NOCLEANDEPENDS
-(bool) Set this to prevent 
-.Cm "make clean"
+.It Va NOCLEANDEPENDS
+.Vt ( bool )
+Set this to prevent
+.Dq Li "make clean"
 from cleaning the ports that the one being cleaned depends on.
-.It Ar NOPORTDOCS
-(bool) Set this to disable installing additional documentation with ports.
-.It Ar PACKAGES
-(str) Used only for the package target; the directory for the package tree.
-.It Ar PATCH_SITES
-(str) Primary location(s) for the distribution of patch files.
-.It Ar PORTSDIR
-(str) The location of the ports tree.
-.It Ar USA_RESIDENT
-(bool) Set this if you are a resident of the USA so that ports that
-need to can attemp to comply with U.S. export regulations.
-.It Ar WRKDIRPREFIX
-(str) Where to create temporary files used when building ports.
-.It Ar X11BASE
-(str) Should be set to where the X11 distribution has been
-installed if it is installed anywhere other than /usr/X11R6.
+.It Va NOPORTDOCS
+.Vt ( bool )
+Set this to disable installing additional documentation with ports.
+.It Va PACKAGES
+.Vt ( str )
+Used only for the package target; the directory for the package tree.
+.It Va PATCH_SITES
+.Vt ( str )
+Primary location(s) for the distribution of patch files.
+.It Va PORTSDIR
+.Vt ( str )
+The location of the ports tree.
+.It Va USA_RESIDENT
+.Vt ( bool )
+Set this if you are a resident of the USA so that ports that
+need to can attempt to comply with U.S. export regulations.
+.It Va WRKDIRPREFIX
+.Vt ( str )
+Where to create temporary files used when building ports.
+.It Va X11BASE
+.Vt ( str )
+Should be set to where the X11 distribution has been
+installed if it is installed anywhere other than
+.Pa /usr/X11R6 .
 .El
 .Sh FILES
 .Bl -tag -width /etc/defaults/make.conf -compact
@@ -517,6 +744,8 @@ The
 file appeared sometime before
 .Fx 4.0 .
 .Sh AUTHORS
+This
+manual page was written by
 .An Mike W. Meyer Aq mwm@mired.org .
 .Sh BUGS
 This manual page may occasionally be out of date with respect to