make.conf(5)

Carl A. Schmidt carl at carlschmidt.net
Mon Sep 5 10:16:30 PDT 2005


Attached is a couple of patches for make.conf and make.conf(5),
bringing them up to the current way of doing things.
-- 
Carl Schmidt
carl at xxxxxxxxxxxxxxx
Index: share/man/man5/make.conf.5
===================================================================
RCS file: /home/carl/cvsup/dfly/src/share/man/man5/make.conf.5,v
retrieving revision 1.9.2000.1
diff -u -r1.9.2000.1 make.conf.5
--- share/man/man5/make.conf.5	4 Sep 2005 20:08:18 -0000	1.9.2000.1
+++ share/man/man5/make.conf.5	5 Sep 2005 16:49:42 -0000
@@ -36,8 +36,7 @@
 .Nm
 contains settings that control the compilation of the
 .Dx
-sources
-and ported applications.
+sources.
 The file
 .Nm
 is generally created by the system administrator when the values need
@@ -45,15 +44,11 @@
 .Pp
 The purpose of
 .Nm
-is not to run commands or perform compilation actions
-directly.
-Instead, it is included by the
-various makefiles in
+is not to run commands or perform compilation actions directly.
+Instead, it is included by the various makefiles in
 .Pa /usr/src
-and
-.Pa /usr/ports
-which conditionalize their
-internal actions according to the settings found there.
+which conditionalize their internal actions according to the
+settings found there.
 .Pp
 The
 .Pa /etc/make.conf
@@ -64,59 +59,37 @@
 .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
+The build procedures occur in three areas: userland, kernel, and
+documentation. Variables set in
 .Nm
-may be applicable during builds in one, two, or all four of these
-areas.
+may be applicable during builds in one, two, or all of these areas.
 They may be specified for a particular build via the
 .Fl D
 option of
 .Xr make 1 .
 .Pp
 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
+variable, as they appear in
+.Pa /etc/defaults/make.conf ,
+you can use during the indicated builds.
+The values of variables flagged as
 .Vt bool
-are ignored; the variable being
-set at all (even to
+are ignored; the variable being set at all (even to
 .Dq Li FALSE
 or
 .Dq Li NO )
-causes it to
-be treated as if it were set.
+causes 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
 .Pa makefiles
 for things other than builds.
 .Bl -tag -width Ar
-.It Va CFLAGS
-.Pq Vt str
-Controls the compiler setting when compiling C code.
-Optimization levels above
-.Fl O
-.Pq Fl O2 , No ...
-are not supported.
-.Va BDECFLAGS
-is provided as a set of
-.Xr gcc 1
-settings suggested by
-.An "Bruce Evans" Aq bde at xxxxxxxxxxx
-for developing and testing changes.
-They can be used, if set, by:
-.Pp
-.Bd -literal -offset indent
-CFLAGS+=${BDECFLAGS}
-.Ed
 .It Va CPUTYPE
 .Pq Vt str
-Controls which processor should be targeted for generated
-code.  This controls processor-specific optimizations in
-certain code (currently only OpenSSL) as well as modifying
-the value of
+Controls which processor should be targeted for generated code.
+This controls processor-specific optimizations in certain code
+(currently only OpenSSL) as well as modifying the value
 .Va CFLAGS
 and
 .Va COPTFLAGS
@@ -130,29 +103,45 @@
 .Va NO_CPU_CFLAGS
 and
 .Va NO_CPU_COPTFLAGS
-variables, respectively.  Refer to
+variables. Refer to
 .Pa /usr/share/examples/etc/defaults/make.conf
 for a list of recognized
-.Va CPUTYPE
+.Pa CPUTYPE
 options.
-.It Va NO_CPU_CFLAGS
-.Pq Vt str
-Setting this variable will prevent CPU specific compiler flags
-from being automatically added to
 .Va CFLAGS
 during compile time.
-.It Va NO_CPU_COPTFLAGS
+.It Va CCVER
+.Pq Vt str
+Controls which GCC version to use by default.  It should be set as
+CCVER?= so as not to interfere with overrides from userland. We
+currently recommend that an override NOT be set in
+.Pa /etc/make.conf .
+Currently accepted values are cc34 and cc40.
+.It Va CFLAGS
+.Pq Vt str
+Controls the compiler settings when compiling C code.
+Optimization levels above
+.Fl O
+.Pq Fl O2 , No ...
+are not supported for compiling world or the kernel - please revert
+any non-standard optimization settings to 
+.Fl O
+before submitting any bug reports.
+.Va BDECFLAGS
+is provided as a set of
+.Xr gcc 1
+settings suggested by
+.An "Bruce Evans" Aq bde at xxxxxxxxxxx
+for developing and testing changes.
+They can be used, if set, by:
+.Pp
+.Bd -literal -offset indent
+CFLAGS+=${BDECFLAGS}
+.Ed
+.It Va NO_CPU_CFLAGS
 .Pq Vt str
 Setting this variable will prevent CPU specific compiler flags
 from being automatically added to
-.Va COPTFLAGS
-during compile time.
-.It Va CVS_UPDATE
-.Pq Vt bool
-Set this to use
-.Xr cvs 1
-to update your ports with
-.Dq Li "make update" .
 .It Va CXXFLAGS
 .Pq Vt str
 Controls the compiler settings when compiling C++ code.
@@ -165,7 +154,21 @@
 value, use
 .Dq Li +=
 instead of
-.Dq Li = .
+.Dq Li =
+so you do not remove the value of
+.Va CFLAGS ,
+which is often times needed.
+.It Va NOCLEAN
+.Pq 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 Va NOCLEANDIR
+.Pq Vt bool
+Set this to run
+.Dq Li "${MAKE} clean"
+instead of
+.Dq Li "${MAKE} cleandir" .
 .It Va INSTALL
 .Pq Vt str
 the default install command.
@@ -176,8 +179,7 @@
 .Ed
 .It Va LOCAL_DIRS
 .Pq Vt str
-List any directories that should be entered when doing
-make's in
+List any directories that should be entered when doing a make in
 .Pa /usr/src
 in this variable.
 .It Va MAKE_SHELL
@@ -204,22 +206,22 @@
 .Pq Vt bool
 Set this to not update the doc tree during
 .Dq Li "make update" .
-.It Va NO_PORTSUPDATE
-.Pq Vt bool
-Set this to not update the ports tree during
-.Dq Li "make update" .
-.It Va SUP_UPDATE
-.Pq Vt bool
-Set this to use
-.Xr cvsup 1
-to update your ports with
-.Dq Li "make update" .
+.It Va STRIP
+.Pq Vt str
+Strip the file before installing. Setting this to nothing will retain
+the debugging symbols in the installed file.
 .It Va SUP
 .Pq Vt str
 The location of the
 .Xr cvsup 1
 command for
 .Dq Li "make update" .
+.It Va SUP_UPDATE
+.Pq Vt bool
+Set this to use
+.Xr cvsup 1
+to update your sources with
+.Dq Li "make update" .
 .It Va SUPFLAGS
 .Pq Vt str
 The flag for the
@@ -256,14 +258,6 @@
 .Dq Li "make update" .
 This defaults to
 .Pa /usr/share/examples/cvsup/secure\-supfile .
-.It Va PORTSSUPFILE
-.Pq Vt str
-The ports
-.Ar supfile
-to use when doing a
-.Dq Li "make update" .
-This defaults to
-.Pa /usr/share/examples/cvsup/ports\-supfile .
 .It Va DOCSUPFILE
 .Pq Vt str
 The documentation
@@ -273,9 +267,12 @@
 This defaults to
 .Pa /usr/share/examples/cvsup/doc\-supfile .
 .It Va WARNS_WERROR
-Causes -Werror to be added to
-.Va CFLAGS
-when WARNS is in effect.
+.Pq Vt bool
+Causes
+.Fl Werror
+to be added when
+.Va WARNS
+is in effect.
 .El
 .Pp
 The following list provides a name and short description for variables
@@ -299,11 +296,10 @@
 set to 0.
 .It Va COPTFLAGS
 .Pq Vt str
-Controls the compiler settings when building the
-kernel.
+Controls the compiler settings when building the kernel.
 Optimization levels above
 .Oo Fl O ( O2 , No ...\& ) Oc
-are not guaranteed to work.
+are not guaranteed to work and serve no real purpose.
 .It Va KERNCONF
 .Pq Vt str
 Controls which kernel configurations will be
@@ -340,6 +336,16 @@
 .It Va MODULES_OVERRIDE
 .Pq Vt str
 Set to a list of modules to build instead of all of them.
+.It Va NO_CPU_COPTFLAGS
+.Pq Vt str
+Setting this variable will prevent CPU specific compiler flags
+from being automatically added to
+.Va COPTFLAGS
+during compile time.
+.It Va NO_KERNELCLEAN
+.Pq Vt bool
+Set this to skip the `clean' process of
+.Dq Li "${MAKE} buildkernel" .
 .It Va NO_KERNELCONFIG
 .Pq Vt bool
 Set this to skip running
@@ -360,90 +366,41 @@
 The following list provides a name and short description for variables
 that are used during the world build:
 .Bl -tag -width Ar
-.It Va COMPAT1X
-.Pq Vt bool
-Set to install the
-.Fx
-1 compatibility libraries.
-.It Va COMPAT20
-.Pq Vt bool
-Set to install the
-.Fx 2.0
-compatibility libraries.
-.It Va COMPAT21
-.Pq Vt bool
-Set to install the
-.Fx 2.1
-compatibility libraries.
-.It Va COMPAT22
-.Pq Vt bool
-Set to install the
-.Fx 2.2
-compatibility libraries.
-.It Va COMPAT3X
-.Pq Vt bool
-Set to install the
-.Fx
-3
-compatibility libraries.
-.It Va COMPAT4X
-.Pq Vt bool
-Set to install the
-.Fx
-4
-compatibility libraries.
-.It Va ENABLE_SUIDPERL
-.Pq Vt bool
-Set to enable the installation of an suid
-.Xr perl 1
-binary.
-.It Va FETCH_CMD
-.Pq Vt str
-Command to use to fetch files.
-Normally
-.Xr fetch 1 .
-.It Va KRB5_HOME
-.Pq Vt str
-If you want to install the MIT Kerberos5 port somewhere other than
-.Pa /usr/local ,
-define this.  This is also used to tell ssh1 that kerberos is needed.
-.It Va MAKE_IDEA
-.Pq 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 Va WANT_KERBEROS
-.Pq Vt bool
-Set this to build Kerberos5 (KTH Heimdal).
-.Em WARNING !
-This is still experimental code.
-If you need stable Kerberos5, use the
-port(s).
-.It Va ENABLE_SUID_K5SU
-.Pq Vt bool
-Set this if you wish to use the k5su utility.  Otherwise, it will be
-installed without the set-user-ID bit set.
 .It Va ENABLE_SUID_SSH
 .Pq Vt bool
 Set this to install
 .Xr ssh 1
 with the setuid bit turned on.
+.It Va FETCH_ENV
+.Pq Vt str
+If you're behind a firewall and need FTP or HTTP proxy services for
+.Xr fetch 1 ,
+the following examples provide the necessary syntax.
+.Pp
+.Bd -literal -offset indent
+FETCH_ENV=FTP_PROXY=ftp://10.0.0.1:21
+FETCH_ENV=FTP_PROXY=http://10.0.0.1:80
+.Ed
 .It Va MODULES_WITH_WORLD
 .Pq Vt bool
 Set to build modules with the system instead of the kernel.
-.It Va NO_CVS
-.Pq Vt bool
-Set to not build CVS.
 .It Va NO_BIND
 .Pq Vt bool
 Set to not build BIND.
+.It Va NO_CRYPT
+.Pq Vt bool
+Set to not build any crypto code.
+.It Va NO_CVS
+.Pq Vt bool
+Set to not build CVS.
 .It Va NO_FORTRAN
 .Pq Vt bool
 Set to not build
 .Xr g77 1
 and related libraries.
+.It Va NO_GAMES
+.Pq Vt bool
+Set to not build games.
 .It Va NO_GDB
 .Pq Vt bool
 Set to not build
@@ -454,6 +411,12 @@
 .It Va NO_IPFILTER
 .Pq Vt bool
 Set to not build IP Filter package.
+.It Va NO_LIBC_R
+.Pq Vt bool
+Set to not build
+.Nm libc_r
+(reentrant version of
+.Nm libc ) .
 .It Va NO_LPR
 .Pq Vt bool
 Set to not build
@@ -464,9 +427,6 @@
 Set to not build the
 .Xr mailwrapper 8
 MTA selector.
-.It Va NOMAN
-.Pq Vt bool
-Set to not build manual pages
 .It Va NO_MAKEDEV
 .Pq Vt bool
 Set to avoid running
@@ -484,11 +444,19 @@
 .Pq Vt bool
 Set to not build OpenSSL (implies
 .Va NO_OPENSSH ) .
+.It Va NO_PKGTOOLS
+.Pq Vt bool
+Set to not build the package management tools.
 .It Va NO_SENDMAIL
 .Pq Vt bool
 Set to not build
 .Xr sendmail 8
 and related programs.
+.It Va NO_SHARE
+.Pq Vt bool
+Set to not enter the
+.Pa share
+subdirectory.
 .It Va NO_SHAREDOCS
 .Pq Vt bool
 Set to not build the
@@ -498,60 +466,38 @@
 .Pq Vt bool
 Set to not compile in X\-Windows support (e.g.\&
 .Xr doscmd 1 ) .
-.It Va NOCLEAN
-.Pq 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 Va NOCLEANDIR
+.It Va NOFSCHG
 .Pq Vt bool
-Set this to run
-.Dq Li "${MAKE} clean"
-instead of
-.Dq Li "${MAKE} cleandir" .
-.It Va NOCRYPT
-.Pq Vt bool
-Set to not build any crypto code.
-.It Va NOGAMES
-.Pq Vt bool
-Set to not build games.
+Set to not install certain system utilities with the fschg flag.
+This is useful in a jailed environment.
 .It Va NOINFO
 .Pq Vt bool
 Set to not make or install
 .Xr info 5
 files.
-.It Va NOLIBC_R
+.It Va NOINFOCOMPRESS
 .Pq Vt bool
-Set to not build
-.Nm libc_r
-(reentrant version of
-.Nm libc ) .
+Set to not compress
+.Xr info 1
+pages.
+.It Va NOMAN
+.Pq Vt bool
+Set to not build manual pages
 .It Va NOMANCOMPRESS
 .Pq Vt bool
 Set to install man pages uncompressed.
-.It Va NOPERL
-.Pq Vt bool
-Set to avoid building
-.Xr perl 1 .
 .It Va NOPROFILE
 .Pq Vt bool
 Set to avoid compiling profiled libraries.
-.It Va NOSHARE
-.Pq Vt bool
-Set to not build in the
-.Pa share
-subdir.
-.It Va PERL_THREADED
+.It Va NOSHARED
 .Pq Vt bool
-Set to enable the building and installation of
-.Xr perl 1
-with thread
-support.
+Set to avoid compiling and installing dynamically linked components.
+NOTE: This may be unsupported in the future.
 .It Va PPP_NOSUID
 .Pq Vt bool
-Set to disable the installation of
+Set this to install
 .Xr ppp 8
-as an suid root program.
+with regular permissions.
 .It Va SENDMAIL_MC
 .Pq Vt str
 The default
@@ -659,18 +605,25 @@
 approximately twice as large as the number of lines in
 .Pa /etc/passwd .
 The default number is 20011.
+.It Va WANT_IDEA
+.Pq 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 Va WANT_KERBEROS
+.Pq Vt bool
+Set this to build Kerberos5 (KTH Heimdal).
+.It Va ENABLE_SUID_K5SU
+.Pq Vt bool
+Set this if you wish to use the k5su utility.  Otherwise, it will be
+installed without the set-user-ID bit set.
 .El
 .Pp
 The following list provides a name and short description for variables
 that are used when building documentation.
 .Bl -tag -width Ar
-.It Va DISTDIR
-.Pq Vt str
-Where distfiles are kept.
-Normally, this is
-.Pa distfiles
-in
-.Va PORTSDIR .
 .It Va DOC_LANG
 .Pq Vt str
 The list of languages and encodings to build and install.
@@ -688,206 +641,6 @@
 .Pp
 The following list provides a name and short description for variables
 that are used when building ports:
-.Bl -tag -width Ar
-.It Va FORCE_PKG_REGISTER
-.Pq Vt bool
-Set this to override any existing package registration.
-.It Va HAVE_MOTIF
-.Pq Vt bool
-Set this if you have Motif on your system.
-.It Va KRB5_HOME
-.Pq Vt str
-Set this if you want to install the MIT Kerberos5 port somewhere
-other than
-.Pa /usr/local .
-.It Va LOCALBASE
-.Pq 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 Va MASTER_SITE_AFTERSTEP
-.Pq Vt str
-Set this to change the master site for AfterStep ports.
-The last
-part of the path must be
-.Dq Li /%SUBDIR%/ .
-.It Va MASTER_SITE_BACKUP
-.Pq 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
-.Dq Li /${DIST_SUBDIR}/ .
-.It Va MASTER_SITE_COMP_SOURCES
-.Pq Vt str
-Controls the master site location for
-.Pa comp.sources
-ports.
-The
-last part of the path must be
-.Dq Li %SUBDIR%/
-.It Va MASTER_SITE_GNOME
-.Pq Vt str
-Controls the master site location for GNOME ports.
-The
-last part of the path must be
-.Dq Li /%SUBDIR%/
-.It Va MASTER_SITE_GNU
-.Pq Vt str
-Controls the master site location for GNU ports.
-The
-last part of the path must be
-.Dq Li /%SUBDIR%/
-.It Va MASTER_SITE_KDE
-.Pq Vt str
-Controls the master site location for KDE ports.
-The
-last part of the path must be
-.Dq Li /%SUBDIR%/
-.It Va MASTER_SITE_FREEBSD
-.Pq Vt bool
-If set, go to the master
-.Fx
-site for all files.
-.It Va MASTER_SITE_MOZILLA
-.Pq Vt str
-Controls the master site location for Mozilla ports.
-The
-last part of the path must be
-.Dq Li /%SUBDIR%/
-.It Va MASTER_SITE_OVERRIDE
-.Pq 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 Va MASTER_SITE_PERL_CPAN
-.Pq 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 Va MASTER_SORT_REGEX
-.Pq 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
-.Pp
-Users of other ccTLD domains should change the
-.Dq Li jp
-to the
-appropriate domain.
-.It Va MASTER_SITE_RINGSERVER
-.Pq Vt str
-Controls the master site location for Ringserver ports.
-The last
-part of the path must be
-.Dq Li /%SUBDIR%/ .
-.It Va MASTER_SITE_RUBY
-.Pq Vt str
-Controls the master site location for Ruby ports.
-The last
-part of the path must be
-.Dq Li /%SUBDIR%/ .
-.It Va MASTER_SITE_SUNSITE
-.Pq Vt str
-Controls the master site location for Sunsite ports.
-The last
-part of the path must be
-.Dq Li /%SUBDIR%/ .
-.It Va MASTER_SITE_TCLTK
-.Pq Vt str
-Controls the master site location for Tcl and Tk ports.
-The last
-part of the path must be
-.Dq Li /%SUBDIR%/ .
-.It Va MASTER_SITE_TEX_CTAN
-.Pq Vt str
-Controls the master site location for TeX ports.
-The last
-part of the path must be
-.Dq Li /%SUBDIR%/ .
-.It Va MASTER_SITE_WINDOWMAKER
-.Pq Vt str
-Controls the master site location for WindowMaker ports.
-The last
-part of the path must be
-.Dq Li /%SUBDIR%/ .
-.It Va MASTER_SITE_XCONTRIB
-.Pq Vt str
-Controls the master site location for contributed X ports.
-The last
-part of the path must be
-.Dq Li /%SUBDIR%/ .
-.It Va MASTER_SITE_XEMACS
-.Pq Vt str
-Controls the master site location for Xemacs ports.
-The last
-part of the path must be
-.Dq Li /%SUBDIR%/ .
-.It Va MASTER_SITE_XFREE
-.Pq Vt str
-Controls the master site location for XFree ports.
-The last
-part of the path must be
-.Dq Li /%SUBDIR%/ .
-.It Va MOTIFLIB
-.Pq Vt str
-Location of
-.Pa libXm.a
-and
-.Pa libXm.so .
-.It Va MOTIF_STATIC
-.Pq 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 Va NOCLEANDEPENDS
-.Pq Vt bool
-Set this to prevent
-.Dq Li "make clean"
-from cleaning the ports that the one being cleaned depends on.
-.It Va NOPORTDOCS
-.Pq Vt bool
-Set this to disable installing additional documentation with ports.
-.It Va PACKAGES
-.Pq Vt str
-Used only for the package target; the directory for the package tree.
-.It Va PATCH_SITES
-.Pq Vt str
-Primary location(s) for the distribution of patch files.
-.It Va PORTSDIR
-.Pq Vt str
-The location of the ports tree.
-.It Va USA_RESIDENT
-.Pq 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 WITHOUT_X11
-.Pq Vt bool
-Set this so that ports that can be built with or without X11
-support will build without X11 support by default.
-.It Va WRKDIRPREFIX
-.Pq Vt str
-Where to create temporary files used when building ports.
-.It Va X11BASE
-.Pq 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
 .It Pa /etc/defaults/make.conf
@@ -910,8 +663,7 @@
 file appeared sometime before
 .Fx 4.0 .
 .Sh AUTHORS
-This
-manual page was written by
+This manual page was written by
 .An Mike W. Meyer Aq mwm at xxxxxxxxx .
 .Sh BUGS
 This manual page may occasionally be out of date with respect to
--- etc/defaults/make.conf	2005-09-05 12:56:36.000000000 -0400
+++ etc/defaults/make.conf	2005-09-05 13:04:08.000000000 -0400
@@ -1,5 +1,5 @@
 # $FreeBSD: src/etc/defaults/make.conf,v 1.97.2.80 2003/02/15 16:34:56 trhodes Exp $
-# $DragonFly: src/etc/defaults/make.conf,v 1.14 2005/09/05 15:36:34 corecode Exp $
+# $DragonFly: src/etc/defaults/make.conf,v 1.13.2000.2 2005/09/05 16:54:28 carl Exp $
 #
 # NOTE:  Please would any committer updating this file also update the
 # make.conf(5) manual page, if necessary, which is located in
@@ -14,7 +14,6 @@
 # You have to find the things you can put here in the Makefiles and 
 # documentation of the source tree.
 #
-#
 # The CPUTYPE variable controls which processor should be targeted for
 # generated code.  This controls processor-specific optimizations in
 # certain code (currently only OpenSSL) as well as modifying the value
@@ -39,77 +38,84 @@
 # The CCVER variable controls which GCC-version to use by default.  It
 # should be set using ?= so as not to interfere with CCVER overrides from
 # userland or the buildworld.  We currently recommend that an override NOT
-# be set in /etc/make.conf and that gcc 3.4 not yet be used to build the boot
-# blocks, boot loader, or the kernel.
-#
-# CCVER?=gcc34	# (use GCC 3.4, default)
-# CCVER?=gcc40	# (use GCC 4.0, experimental, only available
-#               #               if WANT_GCC40 set)
-#
-#
-# Build gcc40 with world.  This won't make gcc40 the default compiler
-#
-#WANT_GCC40=yes
+# be set in /etc/make.conf.
+#CCVER?=gcc34	# (use GCC 3.4, default)
+#CCVER?=gcc40	# (use GCC 4.0, experimental, available with WANT_GCC40)
 # 
-#
 # CFLAGS controls the compiler settings used when compiling C code.
 # Note that optimization settings above -O (-O2, ...) are not recommended
 # or supported for compiling the world or the kernel - please revert any
 # nonstandard optimization settings to "-O" before submitting bug reports
 # to the developers.
-#
 #CFLAGS= -O -pipe
 #
+# To compile just the kernel with special optimizations, you should use
+# this instead of CFLAGS (which is not applicable to kernel builds anyway).
+# There is very little to gain by using higher optimization levels, and doing
+# so can cause problems.
+#COPTFLAGS= -O -pipe
+#
 # CXXFLAGS controls the compiler settings used when compiling C++ code.
 # Note that CXXFLAGS is initially set to the value of CFLAGS.  If you wish
 # to add to CXXFLAGS value, "+=" must be used rather than "=".  Using "="
 # alone will remove the often needed contents of CFLAGS from CXXFLAGS.
-#
 #CXXFLAGS+= -fmemoize-lookups -fsave-memoized
 #
-# BDECFLAGS are a set of gcc warning settings that Bruce Evans has suggested
-# for use in developing FreeBSD and testing changes.  They can be used by
-# putting "CFLAGS+=${BDECFLAGS}" in /etc/make.conf.  -Wconversion is not
-# included here due to compiler bugs, e.g., mkdir()'s mode_t argument.
-#
+# BDECFLAGS are a set of gcc warning settings created by Bruce Evans
+# (bde @ freebsd.org) for use in developing and testing changes.  They
+# can be used by putting "CFLAGS+=${BDECFLAGS}" in /etc/make.conf.
+# -Wconversion is not included here due to compiler bugs, e.g., mkdir()'s
+# mode_t argument.
 BDECFLAGS=	-W -Wall -ansi -pedantic -Wbad-function-cast -Wcast-align \
 		-Wcast-qual -Wchar-subscripts -Winline \
 		-Wmissing-prototypes -Wnested-externs -Wpointer-arith \
 		-Wredundant-decls -Wshadow -Wstrict-prototypes -Wwrite-strings
 #
-# WARNS_WERROR causes -Werror to be added when WARNS is in effect.
+# Compare before install
+#INSTALL=	install -C
 #
-#WARNS_WERROR=	yes
+# List any directories that should be entered when performing a make
+# operation /usr/src
+#LOCAL_DIRS=
+#
+# Controls the shell used internally by make(1) to process the command
+# scripts in makefiles. csh, ksh, and sh are currently supported. sh is
+# the default.
+#MAKE_SH?=sh
 #
-# To compile just the kernel with special optimizations, you should use
-# this instead of CFLAGS (which is not applicable to kernel builds anyway).
-# There is very little to gain by using higher optimization levels, and doing
-# so can cause problems.
+# To build sys/modules when building the world (our old way of doing things)
+#MODULES_WITH_WORLD=true	# do not build modules when building kernel
 #
-#COPTFLAGS= -O -pipe
+# The list of modules to build instead of all of them.
+#MODULES_OVERRIDE=	emulation/linux net/ipfw
 #
-# Strip the file before installing.  Setting this to nothing will keep
-# the debugging symbols in the installed files.
-#STRIP=	-s
+# Set this to cause mtree(8) to follow symlinks.
+#MTREE_FOLLOW_SYMLINKS=	yes
 #
-# Compare before install
-#INSTALL=install -C
+# To avoid running MAKEDEV all on /dev during install:
+#NO_MAKEDEV=	true
 #
-# To enable installing suidperl with the setuid bit turned on
-#ENABLE_SUIDPERL=	true
+# If you do not want unformatted manual pages to be compressed
+# when they are installed:
+#NO_MANCOMPRESS=	true
 #
-# To build ppp with normal permissions
-#PPP_NOSUID=	true
+# Strip the file before installing.  Setting this to nothing will retain
+# the debugging symbols in the installed files.
+#STRIP=	-s
 #
-# To enable installing ssh(1) with the setuid bit turned on
-#ENABLE_SUID_SSH=	true
+# WARNS_WERROR causes -Werror to be added when WARNS is in effect.
+#WARNS_WERROR=	yes
 #
 # To avoid building various parts of the base system:
-#NO_CVS=	true	# do not build CVS
 #NO_BIND=	true	# do not build BIND
+#NO_CRYPT=	true	# do not build any crypto code
+#NO_CVS=	true	# do not build CVS
 #NO_FORTRAN=	true	# do not build g77 and related libraries
+#NO_GAMES=	true	# do not build games (games/ subdir)
+#NO_GDB=	true	# do not build the GNU debugger
 #NO_I4B=	true	# do not build isdn4bsd package
 #NO_IPFILTER=	true	# do not build IP Filter package
+#NO_LIBC_R=	true	# do not build libc_r (re-entrant version of libc)
 #NO_LPR=	true	# do not build lpr and related programs
 #NO_MAILWRAPPER=true	# do not build the mailwrapper(8) MTA selector
 #NO_MODULES=	true	# do not build modules with the kernel
@@ -118,70 +124,40 @@
 #NO_OPENSSL=	true	# do not build OpenSSL (implies NO_OPENSSH)
 #NO_PKGTOOLS=	true	# do not build included package tools (for pkgsrc)
 #NO_SENDMAIL=	true	# do not build sendmail and related programs
+#NO_SHARE=	true	# do not go into the share subdir
 #NO_SHAREDOCS=	true	# do not build the 4.4BSD legacy docs
 #NO_X=		true	# do not compile in XWindows support (e.g. doscmd)
-#NOCRYPT=	true	# do not build any crypto code
-#NOGAMES=	true	# do not build games (games/ subdir)
 #NOINFO=	true	# do not make or install info files
-#NOLIBC_R=	true	# do not build libc_r (re-entrant version of libc)
+#NOINFOCOMPRESS=true	# do not compress info pages
 #NOMAN=		true	# do not build manual pages
+#NOMANCOMPRESS=	true	# do not compress manual pages
 #NOPROFILE=	true	# Avoid compiling profiled libraries
-#NOSHARE=	true	# do not go into the share subdir
+#WANT_GCC40=	true	# Experimental! Build GCC v4.0
+#WANT_KERBEROS=	true	# Kerberos is off by default, uncomment to enable
+#WANT_LUKEMFTPD=true	# Lukemftpd is off by default, uncomment to enable
 #
-# To build sys/modules when building the world (our old way of doing things)
-#MODULES_WITH_WORLD=true	# do not build modules when building kernel
-# The list of modules to build instead of all of them.
-#MODULES_OVERRIDE=	emulation/linux net/ipfw
-#
-# The following controls building optional IDEA code in libcrypto and
-# certain ports.  Patents are involved - you must not use this unless
-# you either have a license or fall within patent 'fair use'
-# provisions.
+# Patents are involved - you must not use this unless you either have
+# a license or fall within patent 'fair use' provisions.
 #
 # *** It is YOUR RESPONSIBILITY to determine if you can use this! ***
 #
 # IDEA is patented in the USA and many European countries - thought to
 # be OK to use for any non-commercial use.  This is optional.
-#MAKE_IDEA=	YES	# IDEA (128 bit symmetric encryption)
-#
-# To avoid running MAKEDEV all on /dev during install:
-#NO_MAKEDEV=	true
-#
-# If you do not want unformatted manual pages to be compressed
-# when they are installed:
-#
-#NOMANCOMPRESS=	true
-#
+#WANT_IDEA=	true	# IDEA (128 bit symmetric encryption)
 #
-# If you want the "compat" shared libraries installed as part of your normal
-# builds, uncomment these:
-#
-#COMPAT1X=	yes
-#COMPAT20=	yes
-#COMPAT21=	yes
-#COMPAT22=	yes
-#COMPAT3X=	yes
-#COMPAT4X=	yes
-#
-#
-# If you do not want additional documentation (some of which are
-# a few hundred KB's) for ports to be installed:
-#
-#NOPORTDOCS=	true
-#
-#
-# Default format for system documentation, depends on your printer.
-# Set this to "ascii" for simple printers or screen
+# Define this to install the k5su utility setuid:
+#ENABLE_SUID_K5SU=	yes
 #
-#PRINTERDEVICE=	ps
+# To enable installing ssh(1) with the setuid bit turned on
+#ENABLE_SUID_SSH=	true
 #
+# To build ppp with normal permissions
+#PPP_NOSUID=	true
 #
 # How long to wait for a console keypress before booting the default kernel.
 # This value is approximately in 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.
-#
 #BOOTWAIT=0
 #BOOTWAIT=30000
 #
@@ -193,175 +169,50 @@
 # a serial port as our console at all.  Alter as necessary.
 #
 #   COM1: = 0x3F8, COM2: = 0x2F8, COM3: = 0x3E8, COM4: = 0x2E8
-#
 #BOOT_COMCONSOLE_PORT=	0x3F8
 #
 # The default serial console speed is 9600.  Set the speed to a larger value
 # for better interactive response.
-#
 #BOOT_COMCONSOLE_SPEED=	115200
 #
 # By default the 'pxeboot' loader retrieves the kernel via NFS.  Defining
 # this and recompiling /usr/src/sys/boot will cause it to retrieve the kernel
 # via TFTP.  This allows pxeboot to load a custom BOOTP diskless kernel yet
 # still mount the server's '/' (i.e. rather than load the server's kernel).
-#
 #LOADER_TFTP_SUPPORT= YES
 #
-# By default, the ports collection attempts to use XFree86 4.X.  If
-# you are running XFree86 3.3.X, uncomment this line.
-#
-#XFREE86_VERSION=	3
-#
-# By default, this points to /usr/X11R6 for XFree86 releases 3.0 or earlier.
-# If you have a XFree86 from before 3.0 that has the X distribution in
-# /usr/X386, you want to uncomment this.
-#
-#X11BASE=	/usr/X386
-#
-#
-# If you have Motif on your system, uncomment this.
-#
-#HAVE_MOTIF=	yes
-#MOTIF_STATIC=  yes
-#
-# If the default location of the Motif library (specified below) is NOT
-# appropriate for you, uncomment this and change it to the correct value.
-# If your motif is in ${X11BASE}/lib, you don't need to touch this line.
-#
-#MOTIFLIB=	-L${X11BASE}/lib -lXm
-#
-#
-# If you're resident in the USA, this will help various ports to determine
-# whether or not they should attempt to comply with the various U.S.
-# export regulations on certain types of software which do not apply to
-# anyone else in the world.
-#
-#USA_RESIDENT=		YES
-#
-#
-# Override "don't install a port that's already installed" behavior.
-# One might wish to do this for ports debugging or to unconditionally
-# reinstall a set of suspect/broken ports.
-#
-#FORCE_PKG_REGISTER=    YES
-#
-#
 # If you're behind a firewall and need FTP or HTTP proxy services for
 # ports collection fetching to work, the following examples give the
 # necessary syntax.  See the fetch(3) man page for details.
-#
 #FETCH_ENV=	FTP_PROXY=ftp://10.0.0.1:21
 #FETCH_ENV=	HTTP_PROXY=http://10.0.0.1:80
 #
-#
-# Port master sites.
-#
-# If you want your port fetches to go somewhere else than the default
-# (specified below) in case the distfile/patchfile was not found,
-# uncomment this and change it to a location nearest you.  (Don't
-# remove the "/${DIST_SUBDIR}/" part.)
-#
-#MASTER_SITE_BACKUP?=	\
-#	ftp://ftp.freebsd.org/pub/FreeBSD/ports/distfiles/${DIST_SUBDIR}/
-#
-# If you want your port fetches to check the above site first (before
-# the MASTER_SITES specified in the port Makefiles), uncomment the
-# line below.  You can also change the right side to point to wherever 
-# you want.
-#
-#MASTER_SITE_OVERRIDE?=	${MASTER_SITE_BACKUP}
-#
-# Some ports use a special variable to point to a collection of
-# mirrors of well-known software archives.  If you have a mirror close
-# to you, uncomment any of the following lines and change it to that
-# address.  (Don't remove the "/%SUBDIR%/" part.)
-#
-# Note: the right hand sides of the following lines are only for your
-# information.  For a full list of default sites, take a look at
-# bsd.sites.mk.
-#
-#MASTER_SITE_AFTERSTEP=	ftp://ftp.afterstep.org/%SUBDIR%/
-#MASTER_SITE_COMP_SOURCES=	ftp://gatekeeper.dec.com/pub/usenet/comp.sources.%SUBDIR%/
-#MASTER_SITE_FREEBSD_ORG=      ftp://ftp.FreeBSD.org/pub/FreeBSD/%SUBDIR%/
-#MASTER_SITE_GNOME=	ftp://ftp.gnome.org/pub/GNOME/%SUBDIR%/
-#MASTER_SITE_GNU=	ftp://ftp.gnu.org/gnu/%SUBDIR%/
-#MASTER_SITE_KDE=	ftp://ftp.kde.org/pub/kde/%SUBDIR%/
-#MASTER_SITE_LOCAL=	ftp://ftp.FreeBSD.org/pub/FreeBSD/ports/local-distfiles/%SUBDIR%/
-#MASTER_SITE_MOZILLA=	ftp://ftp.mozilla.org/pub/%SUBDIR%/
-#MASTER_SITE_NETBSD=	ftp://ftp.netbsd.org/pub/NetBSD/packages/distfiles/%SUBDIR%/
-#MASTER_SITE_PERL_CPAN=	ftp://ftp.digital.com/pub/plan/perl/CPAN/modules/by-module/%SUBDIR%/
-#MASTER_SITE_PORTS_JP=	ftp://ports.jp.FreeBSD.org/pub/FreeBSD-jp/ports-jp/LOCAL_PORTS/%SUBDIR%/
-#MASTER_SITE_RINGSERVER=	ftp://ftp.dnsbalance.ring.gr.jp/pub/%SUBDIR%/
-#MASTER_SITE_RUBY=     ftp://ftp.ruby-lang.org/pub/ruby/%SUBDIR%/
-#MASTER_SITE_SOURCEFORGE=	ftp://ftp2.sourceforge.net/pub/sourceforge/%SUBDIR%/
-#MASTER_SITE_SOURCEWARE=	ftp://ftp.freesoftware.com/pub/sourceware/%SUBDIR%/
-#MASTER_SITE_SUNSITE=	ftp://metalab.unc.edu/pub/Linux/%SUBDIR%/
-#MASTER_SITE_TCLTK=	ftp://ftp.scriptics.com/pub/tcl/%SUBDIR%/
-#MASTER_SITE_TEX_CTAN=	ftp://ftp.tex.ac.uk/tex-archive/%SUBDIR%/
-#MASTER_SITE_THEMES=	ftp://ftp.themes.org/pub/themes/%SUBDIR%/
-#MASTER_SITE_WINDOWMAKER=	ftp://ftp.windowmaker.org/pub/%SUBDIR%/
-#MASTER_SITE_XCONTRIB=	ftp://ftp.x.org/contrib/%SUBDIR%/
-#MASTER_SITE_XEMACS=	ftp://ftp.xemacs.org/pub/xemacs/%SUBDIR%/
-#MASTER_SITE_XFREE=	ftp://ftp.xfree86.org/pub/XFree86/%SUBDIR%/source/
-#
-# Also it is highly recommended that you configure MASTER_SORT_REGEX
-# to choose better mirror sites for you.  List awk(1)-style regular
-# expressions separated by space so MASTER_SITES will be sorted in
-# that order.  The following example is for Japanese users; change
-# "jp" part to your ccTLD ("de", "ru", "uk", etc.) or the domain names
-# of your nearest/upstream networks to meet your needs.
-#
-#MASTER_SORT_REGEX?=	://[^/]*\.jp[/.]
-#
-# Ports can place their working directories somewhere other than under 
-# /usr/ports.  
-#WRKDIRPREFIX=	/var/tmp
-#
-# Kerberos 5
-# If you want Kerberos 5 (KTH Heimdal), define this:
-#
-#WANT_KERBEROS=	yes
-#
-# Kerberos 5 su (k5su)
-# If you want to use the k5su utility, define this to have it installed
-# set-user-ID.
-#ENABLE_SUID_K5SU=	yes
-#
-#
-# Kerberos5
-# If you want to install MIT Kerberos5 port somewhere other than /usr/local,
-# define this (this is also used to tell ssh1 that kerberos is needed):
-#
-#KRB5_HOME=		/usr/local
-#
-#
 # CVSup update flags.  Edit SUPFILE settings to reflect whichever distribution
 # file(s) you use on your site (see /usr/share/examples/cvsup/README for more
 # information on CVSup and these files).  To use, do "make update" in /usr/src.
-#
-#SUP_UPDATE=     yes
-#
-#SUP=            /usr/local/bin/cvsup
-#SUPFLAGS=       -g -L 2
-#SUPHOST=        cvsup.uk.FreeBSD.org
-#SUPFILE=        /usr/share/examples/cvsup/stable-supfile
-#PORTSSUPFILE=   /usr/share/examples/cvsup/ports-supfile
-#DOCSUPFILE=     /usr/share/examples/cvsup/doc-supfile
+#SUP_UPDATE=	yes
+#SUP=		/usr/local/bin/cvsup
+#SUPFLAGS=	-g -L 2
+#SUPHOST=	cvsup.dragonflybsd.org
+#SUPFILE=	/usr/share/examples/cvsup/DragonFly-src-supfile
+#DOCSUPFILE=	/usr/share/examples/cvsup/doc-supfile
+#SUPFILE1=	/usr/share/examples/cvsup/DragonFly-cvs-supfile
+#SUPFILE2=	/usr/share/examples/cvsup/FreeBSD-cvs-supfile
 #
 # top(1) uses a hash table for the user names.  The size of this hash
 # can be tuned to match the number of local users.  The table size should
 # be a prime number approximately twice as large as the number of lines in
 # /etc/passwd.  The default number is 20011.
-#
 #TOP_TABLE_SIZE= 101
 #
 # Documentation
 #
 # The list of languages and encodings to build and install
+#DOC_LANG=	en
 #
-#DOC_LANG=	en_US.ISO8859-1 ru_RU.KOI8-R
-#
+# Default format for system documentation, depends on your printer.
+# Set this to "ascii" for simple printers or screen
+#PRINTERDEVICE=	ps
 #
 # sendmail
 #
@@ -372,7 +223,6 @@
 # Avoid using a value of /etc/mail/sendmail.mc as a buildworld will
 # create /etc/mail/sendmail.cf before installworld installs an
 # updated sendmail binary.
-#
 #SENDMAIL_MC=/etc/mail/myconfig.mc
 #
 # The following sets the default m4 configuration file for mail
@@ -382,7 +232,6 @@
 # Avoid using a value of /etc/mail/submit.mc as a buildworld will
 # create /etc/mail/submit.cf before installworld installs an
 # updated sendmail binary.
-#
 #SENDMAIL_SUBMIT_MC=/etc/mail/mysubmit.mc
 #
 # If you need to build additional .cf files during a make buildworld,
@@ -390,13 +239,11 @@
 # Avoid using a value of /etc/mail/sendmail.mc as a buildworld will
 # create /etc/mail/sendmail.cf before installworld installs an
 # updated sendmail binary.
-#
 #SENDMAIL_ADDITIONAL_MC=/etc/mail/foo.mc /etc/mail/bar.mc
 #
 # Setting the following variable modifies the flags passed to m4 when
 # building a .cf file from a .mc file.  It can be used to enable
 # features disabled by default.
-#
 #SENDMAIL_M4_FLAGS=
 #
 # Setting the following variables modifies the build environment for
@@ -418,7 +265,6 @@
 #	sendmail.mc file:
 #
 #	define(`confDONT_BLAME_SENDMAIL',`GroupReadableSASLDBFile')
-#
 #SENDMAIL_CFLAGS=
 #SENDMAIL_LDFLAGS=
 #SENDMAIL_LDADD=
@@ -429,10 +275,8 @@
 # prevent the installation of /etc/mail/submit.cf.
 # This is a deprecated mode of operation.  See etc/mail/README for more
 # information.
-#
 #SENDMAIL_SET_USER_ID=
 #
 # The permissions to use on alias and map databases generated using
 # /etc/mail/Makefile.  Defaults to 0640.
-#
 #SENDMAIL_MAP_PERMS=




More information about the Submit mailing list