Add comment markers to avoid the same stupid mistake as I made.
[dragonfly.git] / etc / defaults / make.conf
1 # $FreeBSD: src/etc/defaults/make.conf,v 1.97.2.80 2003/02/15 16:34:56 trhodes Exp $
2 # $DragonFly: src/etc/defaults/make.conf,v 1.10 2004/09/16 16:29:39 asmodai Exp $
3 #
4 # NOTE:  Please would any committer updating this file also update the
5 # make.conf(5) manual page, if necessary, which is located in
6 # src/share/man/man5/make.conf.5.
7 #
8 # This file, if present, will be read by make (see /usr/share/mk/sys.mk).
9 # It allows you to override macro definitions to make without changing
10 # your source tree, or anything the source tree installs.
11 #
12 # This file must be in valid Makefile syntax.
13 #
14 # You have to find the things you can put here in the Makefiles and 
15 # documentation of the source tree.
16 #
17 #
18 # The CPUTYPE variable controls which processor should be targeted for
19 # generated code.  This controls processor-specific optimizations in
20 # certain code (currently only OpenSSL) as well as modifying the value
21 # of CFLAGS to contain the appropriate optimization directive to gcc.
22 # The automatic setting of CFLAGS may be overridden using the
23 # NO_CPU_CFLAGS variable below.
24 # Currently the following CPU types are recognized:
25 #   Intel x86 architecture:
26 #       (AMD CPUs)      k7 k6-2 k6 k5
27 #       (Intel CPUs)    p4 p3 p2 i686 i586/mmx i586 i486 i386
28 #   Alpha/AXP architecture: ev6 pca56 ev56 ev5 ev45 ev4
29 #
30 # If you experience any problems after setting this flag, please unset
31 # it again before submitting a bug report or attempting to modify code.
32 # It may be that certain types of software will become unstable after being
33 # compiled with processor-specific (or higher - see below) optimization flags.
34 # If in doubt, do not set CPUTYPE or CFLAGS to non-default values.
35 #
36 #CPUTYPE=i686
37 #NO_CPU_CFLAGS= true    # Don't add -march=<cpu> to CFLAGS automatically
38 #NO_CPU_COPTFLAGS=true  # Don't add -march=<cpu> to COPTFLAGS automatically
39 #
40 # The CCVER variable controls which GCC-version to use by default.  It
41 # should be set using ?= so as not to interfere with CCVER overrides from
42 # userland or the buildworld.  We currently recommend that an override NOT
43 # be set in /etc/make.conf and that gcc 3.4 not yet be used to build the boot
44 # blocks, boot loader, or the kernel.
45 #
46 # CCVER?=gcc2   # (use GCC 2.95.x, default)
47 # CCVER?=gcc34  # (use GCC 3.4, experimental)
48
49 #
50 # CFLAGS controls the compiler settings used when compiling C code.
51 # Note that optimization settings above -O (-O2, ...) are not recommended
52 # or supported for compiling the world or the kernel - please revert any
53 # nonstandard optimization settings to "-O" before submitting bug reports
54 # to the developers.
55 # Note also that at this time the -O2 setting is known to produce BROKEN
56 # CODE on the Alpha platform.
57 #
58 #CFLAGS= -O -pipe
59 #
60 # CXXFLAGS controls the compiler settings used when compiling C++ code.
61 # Note that CXXFLAGS is initially set to the value of CFLAGS.  If you wish
62 # to add to CXXFLAGS value, "+=" must be used rather than "=".  Using "="
63 # alone will remove the often needed contents of CFLAGS from CXXFLAGS.
64 #
65 #CXXFLAGS+= -fmemoize-lookups -fsave-memoized
66 #
67 # BDECFLAGS are a set of gcc warning settings that Bruce Evans has suggested
68 # for use in developing FreeBSD and testing changes.  They can be used by
69 # putting "CFLAGS+=${BDECFLAGS}" in /etc/make.conf.  -Wconversion is not
70 # included here due to compiler bugs, e.g., mkdir()'s mode_t argument.
71 #
72 BDECFLAGS=      -W -Wall -ansi -pedantic -Wbad-function-cast -Wcast-align \
73                 -Wcast-qual -Wchar-subscripts -Winline \
74                 -Wmissing-prototypes -Wnested-externs -Wpointer-arith \
75                 -Wredundant-decls -Wshadow -Wstrict-prototypes -Wwrite-strings
76 #
77 # WARNS_WERROR causes -Werror to be added when WARNS is in effect.
78 #
79 #WARNS_WERROR=  yes
80 #
81 # To compile just the kernel with special optimizations, you should use
82 # this instead of CFLAGS (which is not applicable to kernel builds anyway).
83 # There is very little to gain by using higher optimization levels, and doing
84 # so can cause problems.
85 #
86 #COPTFLAGS= -O -pipe
87 #
88 # Strip the file before installing.  Setting this to nothing will keep
89 # the debugging symbols in the installed files.
90 #STRIP= -s
91 #
92 # Compare before install
93 #INSTALL=install -C
94 #
95 # To enable installing suidperl with the setuid bit turned on
96 #ENABLE_SUIDPERL=       true
97 #
98 # To build ppp with normal permissions
99 #PPP_NOSUID=    true
100 #
101 # To enable installing ssh(1) with the setuid bit turned on
102 #ENABLE_SUID_SSH=       true
103 #
104 # To avoid building various parts of the base system:
105 #NO_CVS=        true    # do not build CVS
106 #NO_BIND=       true    # do not build BIND
107 #NO_FORTRAN=    true    # do not build g77 and related libraries
108 #NO_I4B=        true    # do not build isdn4bsd package
109 #NO_IPFILTER=   true    # do not build IP Filter package
110 #NO_LPR=        true    # do not build lpr and related programs
111 #NO_MAILWRAPPER=true    # do not build the mailwrapper(8) MTA selector
112 #NO_MODULES=    true    # do not build modules with the kernel
113 #NO_OBJC=       true    # do not build Objective C support
114 #NO_OPENSSH=    true    # do not build OpenSSH
115 #NO_OPENSSL=    true    # do not build OpenSSL (implies NO_OPENSSH)
116 #NO_SENDMAIL=   true    # do not build sendmail and related programs
117 #NO_SHAREDOCS=  true    # do not build the 4.4BSD legacy docs
118 #NO_X=          true    # do not compile in XWindows support (e.g. doscmd)
119 #NOCRYPT=       true    # do not build any crypto code
120 #NOGAMES=       true    # do not build games (games/ subdir)
121 #NOINFO=        true    # do not make or install info files
122 #NOLIBC_R=      true    # do not build libc_r (re-entrant version of libc)
123 #NOMAN=         true    # do not build manual pages
124 #NOPERL=        true    # do not build perl. Disables OpenSSL optimizations
125 #NOPROFILE=     true    # Avoid compiling profiled libraries
126 #NOSHARE=       true    # do not go into the share subdir
127 #
128 # To build sys/modules when building the world (our old way of doing things)
129 #MODULES_WITH_WORLD=true        # do not build modules when building kernel
130 #
131 # The list of modules to build instead of all of them.
132 #MODULES_OVERRIDE=      emulation/linux net/ipfw
133 #
134 # The following controls building optional IDEA code in libcrypto and
135 # certain ports.  Patents are involved - you must not use this unless
136 # you either have a license or fall within patent 'fair use'
137 # provisions.
138 #
139 # *** It is YOUR RESPONSIBILITY to determine if you can use this! ***
140 #
141 # IDEA is patented in the USA and many European countries - thought to
142 # be OK to use for any non-commercial use.  This is optional.
143 #MAKE_IDEA=     YES     # IDEA (128 bit symmetric encryption)
144 #
145 # To avoid running MAKEDEV all on /dev during install:
146 #NO_MAKEDEV=    true
147 #
148 # If you do not want unformatted manual pages to be compressed
149 # when they are installed:
150 #
151 #NOMANCOMPRESS= true
152 #
153 #
154 # If you want the "compat" shared libraries installed as part of your normal
155 # builds, uncomment these:
156 #
157 #COMPAT1X=      yes
158 #COMPAT20=      yes
159 #COMPAT21=      yes
160 #COMPAT22=      yes
161 #COMPAT3X=      yes
162 #COMPAT4X=      yes
163 #
164 #
165 # If you do not want additional documentation (some of which are
166 # a few hundred KB's) for ports to be installed:
167 #
168 #NOPORTDOCS=    true
169 #
170 #
171 # Default format for system documentation, depends on your printer.
172 # Set this to "ascii" for simple printers or screen
173 #
174 #PRINTERDEVICE= ps
175 #
176 #
177 # How long to wait for a console keypress before booting the default kernel.
178 # This value is approximately in milliseconds. Keypresses are accepted by the
179 # BIOS before booting from disk, making it possible to give custom boot
180 # parameters even when this is set to 0.
181 #
182 #BOOTWAIT=0
183 #BOOTWAIT=30000
184 #
185 # By default, the system will always use the keyboard/video card as system
186 # console.  However, the boot blocks may be dynamically configured to use a
187 # serial port in addition to or instead of the keyboard/video console.
188 #
189 # By default we use COM1 as our serial console port *if* we're going to use
190 # a serial port as our console at all.  Alter as necessary.
191 #
192 #   COM1: = 0x3F8, COM2: = 0x2F8, COM3: = 0x3E8, COM4: = 0x2E8
193 #
194 #BOOT_COMCONSOLE_PORT=  0x3F8
195 #
196 # The default serial console speed is 9600.  Set the speed to a larger value
197 # for better interactive response.
198 #
199 #BOOT_COMCONSOLE_SPEED= 115200
200 #
201 # By default the 'pxeboot' loader retrieves the kernel via NFS.  Defining
202 # this and recompiling /usr/src/sys/boot will cause it to retrieve the kernel
203 # via TFTP.  This allows pxeboot to load a custom BOOTP diskless kernel yet
204 # still mount the server's '/' (i.e. rather than load the server's kernel).
205 #
206 #LOADER_TFTP_SUPPORT= YES
207 #
208 # By default, the ports collection attempts to use XFree86 4.X.  If
209 # you are running XFree86 3.3.X, uncomment this line.
210 #
211 #XFREE86_VERSION=       3
212 #
213 # By default, this points to /usr/X11R6 for XFree86 releases 3.0 or earlier.
214 # If you have a XFree86 from before 3.0 that has the X distribution in
215 # /usr/X386, you want to uncomment this.
216 #
217 #X11BASE=       /usr/X386
218 #
219 #
220 # If you have Motif on your system, uncomment this.
221 #
222 #HAVE_MOTIF=    yes
223 #MOTIF_STATIC=  yes
224 #
225 # If the default location of the Motif library (specified below) is NOT
226 # appropriate for you, uncomment this and change it to the correct value.
227 # If your motif is in ${X11BASE}/lib, you don't need to touch this line.
228 #
229 #MOTIFLIB=      -L${X11BASE}/lib -lXm
230 #
231 #
232 # If you're resident in the USA, this will help various ports to determine
233 # whether or not they should attempt to comply with the various U.S.
234 # export regulations on certain types of software which do not apply to
235 # anyone else in the world.
236 #
237 #USA_RESIDENT=          YES
238 #
239 #
240 # Override "don't install a port that's already installed" behavior.
241 # One might wish to do this for ports debugging or to unconditionally
242 # reinstall a set of suspect/broken ports.
243 #
244 #FORCE_PKG_REGISTER=    YES
245 #
246 #
247 # If you're behind a firewall and need FTP or HTTP proxy services for
248 # ports collection fetching to work, the following examples give the
249 # necessary syntax.  See the fetch(3) man page for details.
250 #
251 #FETCH_ENV=     FTP_PROXY=ftp://10.0.0.1:21
252 #FETCH_ENV=     HTTP_PROXY=http://10.0.0.1:80
253 #
254 #
255 # Port master sites.
256 #
257 # If you want your port fetches to go somewhere else than the default
258 # (specified below) in case the distfile/patchfile was not found,
259 # uncomment this and change it to a location nearest you.  (Don't
260 # remove the "/${DIST_SUBDIR}/" part.)
261 #
262 #MASTER_SITE_BACKUP?=   \
263 #       ftp://ftp.freebsd.org/pub/FreeBSD/ports/distfiles/${DIST_SUBDIR}/
264 #
265 # If you want your port fetches to check the above site first (before
266 # the MASTER_SITES specified in the port Makefiles), uncomment the
267 # line below.  You can also change the right side to point to wherever 
268 # you want.
269 #
270 #MASTER_SITE_OVERRIDE?= ${MASTER_SITE_BACKUP}
271 #
272 # Some ports use a special variable to point to a collection of
273 # mirrors of well-known software archives.  If you have a mirror close
274 # to you, uncomment any of the following lines and change it to that
275 # address.  (Don't remove the "/%SUBDIR%/" part.)
276 #
277 # Note: the right hand sides of the following lines are only for your
278 # information.  For a full list of default sites, take a look at
279 # bsd.sites.mk.
280 #
281 #MASTER_SITE_AFTERSTEP= ftp://ftp.afterstep.org/%SUBDIR%/
282 #MASTER_SITE_COMP_SOURCES=      ftp://gatekeeper.dec.com/pub/usenet/comp.sources.%SUBDIR%/
283 #MASTER_SITE_FREEBSD_ORG=      ftp://ftp.FreeBSD.org/pub/FreeBSD/%SUBDIR%/
284 #MASTER_SITE_GNOME=     ftp://ftp.gnome.org/pub/GNOME/%SUBDIR%/
285 #MASTER_SITE_GNU=       ftp://ftp.gnu.org/gnu/%SUBDIR%/
286 #MASTER_SITE_KDE=       ftp://ftp.kde.org/pub/kde/%SUBDIR%/
287 #MASTER_SITE_LOCAL=     ftp://ftp.FreeBSD.org/pub/FreeBSD/ports/local-distfiles/%SUBDIR%/
288 #MASTER_SITE_MOZILLA=   ftp://ftp.mozilla.org/pub/%SUBDIR%/
289 #MASTER_SITE_NETBSD=    ftp://ftp.netbsd.org/pub/NetBSD/packages/distfiles/%SUBDIR%/
290 #MASTER_SITE_PERL_CPAN= ftp://ftp.digital.com/pub/plan/perl/CPAN/modules/by-module/%SUBDIR%/
291 #MASTER_SITE_PORTS_JP=  ftp://ports.jp.FreeBSD.org/pub/FreeBSD-jp/ports-jp/LOCAL_PORTS/%SUBDIR%/
292 #MASTER_SITE_RINGSERVER=        ftp://ftp.dnsbalance.ring.gr.jp/pub/%SUBDIR%/
293 #MASTER_SITE_RUBY=     ftp://ftp.ruby-lang.org/pub/ruby/%SUBDIR%/
294 #MASTER_SITE_SOURCEFORGE=       ftp://ftp2.sourceforge.net/pub/sourceforge/%SUBDIR%/
295 #MASTER_SITE_SOURCEWARE=        ftp://ftp.freesoftware.com/pub/sourceware/%SUBDIR%/
296 #MASTER_SITE_SUNSITE=   ftp://metalab.unc.edu/pub/Linux/%SUBDIR%/
297 #MASTER_SITE_TCLTK=     ftp://ftp.scriptics.com/pub/tcl/%SUBDIR%/
298 #MASTER_SITE_TEX_CTAN=  ftp://ftp.tex.ac.uk/tex-archive/%SUBDIR%/
299 #MASTER_SITE_THEMES=    ftp://ftp.themes.org/pub/themes/%SUBDIR%/
300 #MASTER_SITE_WINDOWMAKER=       ftp://ftp.windowmaker.org/pub/%SUBDIR%/
301 #MASTER_SITE_XCONTRIB=  ftp://ftp.x.org/contrib/%SUBDIR%/
302 #MASTER_SITE_XEMACS=    ftp://ftp.xemacs.org/pub/xemacs/%SUBDIR%/
303 #MASTER_SITE_XFREE=     ftp://ftp.xfree86.org/pub/XFree86/%SUBDIR%/source/
304 #
305 # Also it is highly recommended that you configure MASTER_SORT_REGEX
306 # to choose better mirror sites for you.  List awk(1)-style regular
307 # expressions separated by space so MASTER_SITES will be sorted in
308 # that order.  The following example is for Japanese users; change
309 # "jp" part to your ccTLD ("de", "ru", "uk", etc.) or the domain names
310 # of your nearest/upstream networks to meet your needs.
311 #
312 #MASTER_SORT_REGEX?=    ://[^/]*\.jp[/.]
313 #
314 # Ports can place their working directories somewhere other than under 
315 # /usr/ports.  
316 #WRKDIRPREFIX=  /var/tmp
317 #
318 # Kerberos 5
319 # If you want Kerberos 5 (KTH Heimdal), define this:
320 #
321 #MAKE_KERBEROS5=        yes
322 #
323 # Kerberos 5 su (k5su)
324 # If you want to use the k5su utility, define this to have it installed
325 # set-user-ID.
326 #ENABLE_SUID_K5SU=      yes
327 #
328 #
329 # Kerberos5
330 # If you want to install MIT Kerberos5 port somewhere other than /usr/local,
331 # define this (this is also used to tell ssh1 that kerberos is needed):
332 #
333 #KRB5_HOME=             /usr/local
334 #
335 #
336 # CVSup update flags.  Edit SUPFILE settings to reflect whichever distribution
337 # file(s) you use on your site (see /usr/share/examples/cvsup/README for more
338 # information on CVSup and these files).  To use, do "make update" in /usr/src.
339 #
340 #SUP_UPDATE=     yes
341 #
342 #SUP=            /usr/local/bin/cvsup
343 #SUPFLAGS=       -g -L 2
344 #SUPHOST=        cvsup.uk.FreeBSD.org
345 #SUPFILE=        /usr/share/examples/cvsup/stable-supfile
346 #PORTSSUPFILE=   /usr/share/examples/cvsup/ports-supfile
347 #DOCSUPFILE=     /usr/share/examples/cvsup/doc-supfile
348 #
349 # top(1) uses a hash table for the user names.  The size of this hash
350 # can be tuned to match the number of local users.  The table size should
351 # be a prime number approximately twice as large as the number of lines in
352 # /etc/passwd.  The default number is 20011.
353 #
354 #TOP_TABLE_SIZE= 101
355 #
356 # Documentation
357 #
358 # The list of languages and encodings to build and install
359 #
360 #DOC_LANG=      en_US.ISO8859-1 ru_RU.KOI8-R
361 #
362 #
363 # sendmail
364 #
365 # The following sets the default m4 configuration file to use at
366 # install time.  Use with caution as a make install will overwrite
367 # any existing /etc/mail/sendmail.cf.  Note that SENDMAIL_CF is now
368 # deprecated.  The value should be a fully qualified path name.
369 # Avoid using a value of /etc/mail/sendmail.mc as a buildworld will
370 # create /etc/mail/sendmail.cf before installworld installs an
371 # updated sendmail binary.
372 #
373 #SENDMAIL_MC=/etc/mail/myconfig.mc
374 #
375 # The following sets the default m4 configuration file for mail
376 # submission to use at install time.  Use with caution as a make
377 # install will overwrite any existing /etc/mail/submit.cf.  The
378 # value should be a fully qualified path name.
379 # Avoid using a value of /etc/mail/submit.mc as a buildworld will
380 # create /etc/mail/submit.cf before installworld installs an
381 # updated sendmail binary.
382 #
383 #SENDMAIL_SUBMIT_MC=/etc/mail/mysubmit.mc
384 #
385 # If you need to build additional .cf files during a make buildworld,
386 # include the full paths to the .mc files in SENDMAIL_ADDITIONAL_MC.
387 # Avoid using a value of /etc/mail/sendmail.mc as a buildworld will
388 # create /etc/mail/sendmail.cf before installworld installs an
389 # updated sendmail binary.
390 #
391 #SENDMAIL_ADDITIONAL_MC=/etc/mail/foo.mc /etc/mail/bar.mc
392 #
393 # Setting the following variable modifies the flags passed to m4 when
394 # building a .cf file from a .mc file.  It can be used to enable
395 # features disabled by default.
396 #
397 #SENDMAIL_M4_FLAGS=
398 #
399 # Setting the following variables modifies the build environment for
400 # sendmail and its related utilities. For example, SASL support can be
401 # added with settings such as:
402 #
403 #    with SASLv1:
404 #       SENDMAIL_CFLAGS=-I/usr/local/include/sasl1 -DSASL
405 #       SENDMAIL_LDFLAGS=-L/usr/local/lib
406 #       SENDMAIL_LDADD=-lsasl
407 #
408 #    with SASLv2:
409 #       SENDMAIL_CFLAGS=-I/usr/local/include -DSASL=2
410 #       SENDMAIL_LDFLAGS=-L/usr/local/lib
411 #       SENDMAIL_LDADD=-lsasl2
412 #
413 # Note: If you are using Cyrus SASL with other applications which require
414 #       access to the sasldb file, you should add the following to your
415 #       sendmail.mc file:
416 #
417 #       define(`confDONT_BLAME_SENDMAIL',`GroupReadableSASLDBFile')
418 #
419 #SENDMAIL_CFLAGS=
420 #SENDMAIL_LDFLAGS=
421 #SENDMAIL_LDADD=
422 #SENDMAIL_DPADD=
423 #
424 # Setting SENDMAIL_SET_USER_ID will install the sendmail binary as a
425 # set-user-ID root binary instead of a set-group-ID smmsp binary and will
426 # prevent the installation of /etc/mail/submit.cf.
427 # This is a deprecated mode of operation.  See etc/mail/README for more
428 # information.
429 #
430 #SENDMAIL_SET_USER_ID=
431 #
432 # The permissions to use on alias and map databases generated using
433 # /etc/mail/Makefile.  Defaults to 0640.
434 #
435 #SENDMAIL_MAP_PERMS=