xref: /freebsd/share/man/man5/make.conf.5 (revision d668f22a0c71214b6b330ea9529fce45402264e7)
1.\" Copyright (c) 2000
2.\"	Mike W. Meyer
3.\"
4.\" Redistribution and use in source and binary forms, with or without
5.\" modification, are permitted provided that the following conditions
6.\" are met:
7.\" 1. Redistributions of source code must retain the above copyright
8.\"    notice, this list of conditions and the following disclaimer.
9.\" 2. Redistributions in binary form must reproduce the above copyright
10.\"    notice, this list of conditions and the following disclaimer in the
11.\"    documentation and/or other materials provided with the distribution.
12.\"
13.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND
14.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
15.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
16.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR BE LIABLE
17.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
18.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
19.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
20.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
21.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
22.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
23.\" SUCH DAMAGE.
24.\"
25.\" $FreeBSD$
26.\"
27.Dd March 2, 2005
28.Dt MAKE.CONF 5
29.Os
30.Sh NAME
31.Nm make.conf
32.Nd system build information
33.Sh DESCRIPTION
34The file
35.Nm
36contains settings that control the compilation of the
37.Fx
38sources
39and ported applications.
40The file
41.Nm
42is generally created by the system administrator when the values need
43to be changed from their defaults.
44.Pp
45The purpose of
46.Nm
47is not to run commands or perform compilation actions
48directly.
49Instead, it is included by the
50various makefiles in
51.Pa /usr/src ,
52.Pa /usr/ports
53and
54.Pa /usr/doc
55which conditionalize their
56internal actions according to the settings found there.
57.Pp
58The
59.Pa /etc/make.conf
60file is included from the appropriate
61.Pa Makefile
62which specifies the default settings for all the available options.
63Options need only be specified in
64.Pa /etc/make.conf
65when the system administrator wishes to override these defaults.
66.Pp
67The build procedures occur in four broad areas: the world, the kernel,
68documentations and ports.
69Variables set in
70.Nm
71may be applicable during builds in one, two, or all four of these
72areas.
73They may be specified for a particular build via the
74.Fl D
75option of
76.Xr make 1 .
77.Pp
78The following lists provide a name and short description for each
79variable you can use during the indicated builds.
80The values of
81variables flagged as
82.Vt bool
83are ignored; the variable being
84set at all (even to
85.Dq Li FALSE
86or
87.Dq Li NO )
88causes it to
89be treated as if it were set.
90.Pp
91The following list provides a name and short description for variables
92that are used for all builds, or are used by the
93.Pa makefiles
94for things other than builds.
95.Bl -tag -width Ar
96.It Va ALWAYS_CHECK_MAKE
97.Pq Vt bool
98Instructs the top-level makefile in the source tree (normally
99.Pa /usr/src )
100to always check if
101.Xr make 1
102is up-to-date.
103Normally this is only done for the world and buildworld targets to handle
104upgrades from older versions of
105.Fx .
106.It Va CFLAGS
107.Pq Vt str
108Controls the compiler setting when compiling C code.
109Optimization levels other than
110.Fl O
111and
112.Fl O2
113are not supported.
114.Va BDECFLAGS
115is provided as a set of
116.Xr gcc 1
117settings suggested by
118.An "Bruce Evans" Aq bde@FreeBSD.org
119for developing and testing changes.
120They can be used, if set, by:
121.Pp
122.Bd -literal -offset indent
123CFLAGS+=${BDECFLAGS}
124.Ed
125.It Va CPUTYPE
126.Pq Vt str
127Controls which processor should be targeted for generated
128code.
129This controls processor-specific optimizations in
130certain code (currently only OpenSSL) as well as modifying
131the value of
132.Va CFLAGS
133and
134.Va COPTFLAGS
135to contain the appropriate optimization directive to
136.Xr gcc 1 .
137The automatic setting of
138.Va CFLAGS
139and
140.Va COPTFLAGS
141may be overridden using the
142.Va NO_CPU_CFLAGS
143and
144.Va NO_CPU_COPTFLAGS
145variables, respectively.
146Refer to
147.Pa /usr/share/examples/etc/make.conf
148for a list of recognized
149.Va CPUTYPE
150options.
151.It Va NO_CPU_CFLAGS
152.Pq Vt str
153Setting this variable will prevent CPU specific compiler flags
154from being automatically added to
155.Va CFLAGS
156during compile time.
157.It Va NO_CPU_COPTFLAGS
158.Pq Vt str
159Setting this variable will prevent CPU specific compiler flags
160from being automatically added to
161.Va COPTFLAGS
162during compile time.
163.It Va CVS_UPDATE
164.Pq Vt bool
165Set this to use
166.Xr cvs 1
167to update your ports with
168.Dq Li "make update" .
169.It Va CXXFLAGS
170.Pq Vt str
171Controls the compiler settings when compiling C++ code.
172.Va CXXFLAGS
173is initially set to the value of
174.Va CFLAGS .
175If you want to
176add to the
177.Va CXXFLAGS
178value, use
179.Dq Li +=
180instead of
181.Dq Li = .
182.It Va INSTALL
183.Pq Vt str
184the default install command.
185To install only files for which the target differs or does not exist, use
186.Bd -literal -offset indent
187INSTALL="install -C"
188.Ed
189Note that some makefiles (including those in
190.Pa /usr/share/mk )
191may hardcode options for the supplied install command.
192.It Va LOCAL_DIRS
193.Pq Vt str
194List any directories that should be entered when doing
195make's in
196.Pa /usr/src
197in this variable.
198.It Va MAKE_SHELL
199.Pq Vt str
200Controls the shell used internally by
201.Xr make 1
202to process the command scripts in makefiles.
203.Xr sh 1 ,
204.Xr ksh 1 ,
205and
206.Xr csh 1
207all currently supported.
208.Pp
209.Dl "MAKE_SHELL?=sh"
210.It Va MTREE_FOLLOWS_SYMLINKS
211.Pq Vt str
212Set this to
213.Dq Fl L
214to cause
215.Xr mtree 8
216to follow symlinks.
217.It Va NO_DOCUPDATE
218.Pq Vt bool
219Set this to not update the doc tree during
220.Dq Li "make update" .
221.It Va NO_PORTSUPDATE
222.Pq Vt bool
223Set this to not update the ports tree during
224.Dq Li "make update" .
225.It Va SUP_UPDATE
226.Pq Vt bool
227Set this to use
228.Xr cvsup 1
229to update your ports with
230.Dq Li "make update" .
231.It Va SUP
232.Pq Vt str
233The location of the
234.Xr cvsup 1
235command for
236.Dq Li "make update" .
237.It Va SUPFLAGS
238.Pq Vt str
239The flag for the
240.Xr sup 1
241command when doing
242.Dq Li "make update" .
243This defaults to
244.Op Fl g L Ar 2 .
245.It Va SUPHOST
246.Pq Vt str
247The hostname of the sup server to use when doing
248.Dq Li "make update" .
249.It Va SUPFILE
250.Pq Vt str
251The first
252.Ar supfile
253to use when doing a
254.Dq Li "make update" .
255This defaults to
256.Pa /usr/share/examples/cvsup/standard\-supfile .
257.It Va SUPFILE1
258.Pq Vt str
259The second
260.Ar supfile
261to use when doing a
262.Dq Li "make update" .
263This defaults to
264.Pa /usr/share/examples/cvsup/secure\-supfile .
265.It Va SUPFILE2
266.Pq Vt str
267The third
268.Ar supfile
269to use when doing a
270.Dq Li "make update" .
271This defaults to
272.Pa /usr/share/examples/cvsup/secure\-supfile .
273.It Va PORTSSUPFILE
274.Pq Vt str
275The ports
276.Ar supfile
277to use when doing a
278.Dq Li "make update" .
279This defaults to
280.Pa /usr/share/examples/cvsup/ports\-supfile .
281.It Va DOCSUPFILE
282.Pq Vt str
283The documentation
284.Ar supfile
285to use when doing a
286.Dq Li "make update" .
287This defaults to
288.Pa /usr/share/examples/cvsup/doc\-supfile .
289.El
290.Pp
291The following list provides a name and short description for variables
292that are only used doing a kernel build:
293.Bl -tag -width Ar
294.It Va BOOT_COMCONSOLE_PORT
295.Pq Vt str
296The port address to use for the console if the boot blocks have
297been configured to use a serial console instead of the keyboard/video card.
298.It Va BOOT_COMCONSOLE_SPEED
299.Pq Vt int
300The baud rate to use for the console if the boot blocks have
301been configured to use a serial console instead of the keyboard/video card.
302.It Va BOOTWAIT
303.Pq Vt int
304Controls the amount of time the kernel waits for a console keypress
305before booting the default kernel.
306The value is approximately milliseconds.
307Keypresses are accepted by the BIOS before booting from disk,
308making it possible to give custom boot parameters even when this is
309set to 0.
310.It Va COPTFLAGS
311.Pq Vt str
312Controls the compiler settings when building the
313kernel.
314Optimization levels above
315.Oo Fl O ( O2 , No ...\& ) Oc
316are not guaranteed to work.
317.It Va KERNCONF
318.Pq Vt str
319Controls which kernel configurations will be
320built by
321.Dq Li "${MAKE} buildkernel"
322and installed by
323.Dq Li "${MAKE} installkernel" .
324For example,
325.Bd -literal -offset indent
326KERNCONF=MINE DEBUG GENERIC OTHERMACHINE
327.Ed
328.Pp
329will build the kernels specified by the config files
330.Pa MINE , DEBUG , GENERIC ,
331and
332.Pa OTHERMACHINE ,
333and install the kernel specified by the config file
334.Pa MINE .
335It defaults to
336.Pa GENERIC .
337.It Va LOADER_TFTP_SUPPORT
338.Pq Vt bool
339While not a buildkernel-affected option, there is no better place for this.
340By default the
341.Xr pxeboot 8
342loader retrieves the kernel via NFS.
343Defining this and recompiling
344.Pa /usr/src/sys/boot
345will cause it to retrieve the kernel via TFTP.
346This allows
347.Xr pxeboot 8
348to load a custom BOOTP diskless kernel yet
349still mount the server's
350.Pa /
351rather than load the server's kernel.
352.It Va MODULES_OVERRIDE
353.Pq Vt str
354Set to a list of modules to build instead of all of them.
355.It Va WITHOUT_MODULES
356.Pq Vt str
357Set to a list of modules to exclude from the build.
358This provides a
359somewhat easier way to exclude modules you are certain you will never
360need than specifying
361.Va MODULES_OVERRIDE .
362This is applied
363.Em after
364.Va MODULES_OVERRIDE .
365.It Va PORTS_MODULES
366Set this to the list of ports you wish to rebuild every time the kernel
367is built.
368.It Va NO_KERNELCONFIG
369.Pq Vt bool
370Set this to skip running
371.Xr config 8
372during
373.Dq Li "${MAKE} buildkernel" .
374.It Va NO_KERNELDEPEND
375.Pq Vt bool
376Set this to skip running
377.Dq Li "${MAKE} depend"
378during
379.Dq Li "${MAKE} buildkernel" .
380.It Va NO_MODULES
381.Pq Vt bool
382Set to not build modules with the kernel.
383.El
384.Pp
385The following list provides a name and short description for variables
386that are used during the world build:
387.Bl -tag -width Ar
388.It Va MAKE_IDEA
389.Pq Vt bool
390Set to build the IDEA encryption code.
391This code is patented in the USA and many European countries.
392It is
393.Em "YOUR RESPONSIBILITY"
394to determine if you can legally use IDEA.
395.It Va NO_DYNAMICROOT
396.Pq Vt bool
397Set this if you do not want to link
398.Pa /bin
399and
400.Pa /sbin
401dynamically.
402.It Va NO_KERBEROS
403.Pq Vt bool
404Set this if you do not want to build Kerberos 5 (KTH Heimdal).
405.It Va ENABLE_SUID_K5SU
406.Pq Vt bool
407Set this if you wish to use the ksu utility.
408Otherwise, it will be
409installed without the set-user-ID bit set.
410.It Va ENABLE_SUID_NEWGRP
411.Pq Vt bool
412Set this to install
413.Xr newgrp 1
414with the set-user-ID bit set.
415Otherwise,
416.Xr newgrp 1
417will not be able to change users' groups.
418.It Va ENABLE_SUID_SSH
419.Pq Vt bool
420Set this to install
421.Xr ssh 1
422with the set-user-ID bit turned on.
423.It Va MODULES_WITH_WORLD
424.Pq Vt bool
425Set to build modules with the system instead of the kernel.
426.It Va NO_BLUETOOTH
427.Pq Vt bool
428Set to not build Bluetooth related kernel modules, programs and libraries.
429.It Va NO_BOOT
430.Pq Vt bool
431Set to not build the boot blocks and loader.
432.It Va NO_CVS
433.Pq Vt bool
434Set to not build CVS.
435.It Va NO_CXX
436.Pq Vt bool
437Set to not build
438.Xr g++ 1
439and related libraries.
440.It Va NO_DICT
441.Pq Vt bool
442Set to not build the Webster dictionary files.
443.It Va NO_FORTRAN
444.Pq Vt bool
445Set to not build
446.Xr g77 1
447and related libraries.
448.It Va NO_GDB
449.Pq Vt bool
450Set to not build
451.Xr gdb 1 .
452.It Va NO_GPIB
453.Pq Vt bool
454Set to not build GPIB bus support.
455.It Va NO_I4B
456.Pq Vt bool
457Set to not build isdn4bsd package.
458.It Va NO_IPFILTER
459.Pq Vt bool
460Set to not build IP Filter package.
461.It Va NO_PF
462.Pq Vt bool
463Set to not build PF firewall package.
464.It Va NO_AUTHPF
465.Pq Vt bool
466Set to not build
467.Xr authpf 8 .
468.It Va NO_TOOLCHAIN
469.Pq Vt bool
470Set to not build
471programs used for program development,
472compilers, debuggers etc.
473.It Va NO_INET6
474.Pq Vt bool
475Set to not build
476programs and libraries related to IPv6 networking.
477.It Va NO_ATM
478.Pq Vt bool
479Set to not build
480programs and libraries related to ATM networking.
481.It Va NO_USB
482.Pq Vt bool
483Set to not build
484.Xr usbd 8
485and related programs.
486.It Va NO_LPR
487.Pq Vt bool
488Set to not build
489.Xr lpr 1
490and related programs.
491.It Va NO_ACPI
492.Pq Vt bool
493Set to not build
494.Xr acpiconf 8 ,
495.Xr acpidump 8
496and related programs.
497.It Va NO_MAILWRAPPER
498.Pq Vt bool
499Set to not build the
500.Xr mailwrapper 8
501MTA selector.
502.It Va NO_MAN
503.Pq Vt bool
504Set to not build manual pages.
505.It Va NO_NETCAT
506.Pq Vt bool
507Set to not build
508.Xr nc 1
509utility.
510.It Va NO_NIS
511.Pq Vt bool
512Set to not build
513.Xr NIS 8
514support and related programs.
515.It Va NO_OBJC
516.Pq Vt bool
517Set to not build Objective C support.
518.It Va NO_OPENSSH
519.Pq Vt bool
520Set to not build OpenSSH.
521.It Va NO_OPENSSL
522.Pq Vt bool
523Set to not build OpenSSL (implies
524.Va NO_KERBEROS
525and
526.Va NO_OPENSSH ) .
527.It Va NO_SENDMAIL
528.Pq Vt bool
529Set to not build
530.Xr sendmail 8
531and related programs.
532.It Va NO_SHAREDOCS
533.Pq Vt bool
534Set to not build the
535.Bx 4.4
536legacy docs.
537.It Va NO_TCSH
538.Pq Vt bool
539Set to not build and install
540.Pa /bin/csh
541(which is
542.Xr tcsh 1 ) .
543.It Va NO_CLEAN
544.Pq Vt bool
545Set this to disable cleaning during
546.Dq Li "make buildworld" .
547This should not be set unless you know what you are doing.
548.It Va NO_CLEANDIR
549.Pq Vt bool
550Set this to run
551.Dq Li "${MAKE} clean"
552instead of
553.Dq Li "${MAKE} cleandir" .
554.It Va NO_CRYPT
555.Pq Vt bool
556Set to not build any crypto code.
557.It Va NO_GAMES
558.Pq Vt bool
559Set to not build games.
560.It Va NO_INFO
561.Pq Vt bool
562Set to not make or install
563.Xr info 5
564files.
565.It Va NO_LIBC_R
566.Pq Vt bool
567Set to not build
568.Nm libc_r
569(reentrant version of
570.Nm libc ) .
571.It Va NO_LIBPTHREAD
572.Pq Vt bool
573Set to not build the
574.Nm libpthread
575(M:N threading)
576library.
577.It Va NO_LIBTHR
578.Pq Vt bool
579Set to not build the
580.Nm libthr
581(1:1 threading)
582library.
583.It Va NO_MANCOMPRESS
584.Pq Vt bool
585Set to install man pages uncompressed.
586.It Va NO_PROFILE
587.Pq Vt bool
588Set to avoid compiling profiled libraries.
589.It Va NO_SHARE
590.Pq Vt bool
591Set to not build in the
592.Pa share
593subdir.
594.It Va NO_SHARED
595.Pq Vt bool
596Set to not build
597.Pa /bin
598and
599.Pa /sbin
600dynamically linked, this can be bad.
601.It Va NO_BIND
602.Pq Vt bool
603Setting this variable will prevent any part of BIND from being built,
604regardless of the presence of any of the other *_BIND_* variables below.
605.It Va NO_BIND_DNSSEC
606.Pq Vt bool
607Set to avoid building or installing the DNSSEC related binaries,
608.Xr dnssec-keygen 8
609and
610.Xr dnssec-signzone 8 .
611.It Va NO_BIND_ETC
612.Pq Vt bool
613Set to avoid installing the default files to
614.Pa /var/named/etc/namedb .
615.It Va NO_BIND_LIBS_LWRES
616.Pq Vt bool
617Set to avoid installing the lightweight resolver library in
618.Pa /usr/lib .
619The library that is private to the build system may still be built as needed.
620.It Va NO_BIND_MTREE
621.Pq Vt bool
622Set to avoid running
623.Xr mtree 8
624to create the chroot directory structure under
625.Pa /var/named ,
626and avoid creating an
627.Pa /etc/namedb
628symlink to the chroot directory.
629This option should typically be used together with
630.Vt NO_BIND_ETC .
631.It Va NO_BIND_NAMED
632.Pq Vt bool
633Set to avoid building or installing
634.Xr named 8 ,
635.Xr named.reload 8 ,
636.Xr named-checkconf 8 ,
637.Xr named-checkzone 8 ,
638.Xr rndc 8 ,
639and
640.Xr rndc-confgen 8 .
641.It Va NO_BIND_UTILS
642.Pq Vt bool
643Set to avoid building or installing the BIND userland utilities,
644.Xr dig 1 ,
645.Xr host 1 ,
646.Xr nslookup 1 ,
647and
648.Xr nsupdate 8 .
649.It Va WITH_BIND_LIBS
650.Pq Vt bool
651Set to install BIND libraries and include files.
652.It Va PPP_NO_NAT
653.Pq Vt bool
654Build
655.Xr ppp 8
656without support for network address translation (NAT).
657.It Va PPP_NO_NETGRAPH
658.Pq Vt bool
659Set to build
660.Xr ppp 8
661without support for Netgraph.
662.It Va PPP_NO_RADIUS
663.Pq Vt bool
664Set to build
665.Xr ppp 8
666without support for RADIUS.
667.It Va PPP_NO_SUID
668.Pq Vt bool
669Set to disable the installation of
670.Xr ppp 8
671as a set-user-ID root program.
672.It Va NO_RCMDS
673.Pq Vt bool
674Disable building of the
675.Tn BSD
676r-commands.
677This includes
678.Xr rlogin 1 ,
679.Xr rsh 1 ,
680etc.
681.It Va SENDMAIL_MC
682.Pq Vt str
683The default
684.Xr m4 1
685configuration file to use at install time.
686The value should include the full path to the
687.Pa .mc
688file, e.g.,
689.Pa /etc/mail/myconfig.mc .
690Use with caution as a make install will overwrite any existing
691.Pa /etc/mail/sendmail.cf .
692Note that
693.Va SENDMAIL_CF
694is now deprecated.
695.It Va SENDMAIL_SUBMIT_MC
696.Pq Vt str
697The default
698.Xr m4 1
699configuration file for mail submission
700to use at install time.
701The value should include the full path to the
702.Pa .mc
703file, e.g.,
704.Pa /etc/mail/mysubmit.mc .
705Use with caution as a make install will overwrite any existing
706.Pa /etc/mail/submit.cf .
707.It Va SENDMAIL_ADDITIONAL_MC
708.Pq Vt str
709Additional
710.Pa .mc
711files which should be built into
712.Pa .cf
713files at build time.
714The value should include the full path to the
715.Pa .mc
716file(s), e.g.,
717.Pa /etc/mail/foo.mc
718.Pa /etc/mail/bar.mc .
719.It Va SENDMAIL_CF_DIR
720.Pq Vt str
721Override the default location for the
722.Xr m4 1
723configuration files used to build a
724.Pa .cf
725file from a
726.Pa .mc
727file.
728.It Va SENDMAIL_M4_FLAGS
729.Pq Vt str
730Flags passed to
731.Xr m4 1
732when building a
733.Pa .cf
734file from a
735.Pa .mc
736file.
737.It Va SENDMAIL_CFLAGS
738.Pq Vt str
739Flags to pass to the compile command when building
740.Xr sendmail 8 .
741The
742.Va SENDMAIL_*
743flags can be used to provide SASL support with setting such as:
744.Bd -literal -offset indent
745SENDMAIL_CFLAGS=-I/usr/local/include -DSASL
746SENDMAIL_LDFLAGS=-L/usr/local/lib
747SENDMAIL_LDADD=-lsasl
748.Ed
749.It Va SENDMAIL_LDFLAGS
750.Pq Vt str
751Flags to pass to the
752.Xr ld 1
753command when building
754.Xr sendmail 8 .
755.It Va SENDMAIL_LDADD
756.Pq Vt str
757Flags to add to the end of the
758.Xr ld 1
759command when building
760.Xr sendmail 8 .
761.It Va SENDMAIL_DPADD
762.Pq Vt str
763Extra dependencies to add when building
764.Xr sendmail 8 .
765.It Va SENDMAIL_SET_USER_ID
766.Pq Vt bool
767If set, install
768.Xr sendmail 8
769as a set-user-ID root binary instead of a set-group-ID binary
770and do not install
771.Pa /etc/mail/submit.{cf,mc} .
772Use of this flag is not recommended and the alternative advice in
773.Pa /etc/mail/README
774should be followed instead if at all possible.
775.It Va SENDMAIL_MAP_PERMS
776.Pq Vt str
777Mode to use when generating alias and map database files using
778.Pa /etc/mail/Makefile .
779The default value is 0640.
780.It Va TOP_TABLE_SIZE
781.Pq Vt int
782.Xr top 1
783uses a hash table for the user names.
784The size of this hash can be tuned to match the number of local users.
785The table size should be a prime number
786approximately twice as large as the number of lines in
787.Pa /etc/passwd .
788The default number is 20011.
789.It Va WANT_FORCE_OPTIMIZATION_DOWNGRADE
790.Pq Vt int
791Causes the system compiler to be built such that it forces high optimization
792levels to a lower one.
793.Xr gcc 1
794.Fl O2
795and above is known to trigger known optimizer bugs at various
796times \(em this is worse on the Alpha platform.
797The value assigned is the highest optimization value used.
798.El
799.Pp
800The following list provides a name and short description for variables
801that are used when building documentation.
802.Bl -tag -width Ar
803.It Va DISTDIR
804.Pq Vt str
805Where distfiles are kept.
806Normally, this is
807.Pa distfiles
808in
809.Va PORTSDIR .
810.It Va DOC_LANG
811.Pq Vt str
812The list of languages and encodings to build and install.
813.It Va PRINTERDEVICE
814.Pq Vt str
815The default format for system documentation, depends on your
816printer.
817This can be set to
818.Dq Li ascii
819for simple printers, or
820.Dq Li ps
821for postscript or graphics printers with a ghostscript
822filter, or both.
823.El
824.Sh FILES
825.Bl -tag -width ".Pa /usr/share/examples/etc/make.conf" -compact
826.It Pa /etc/make.conf
827.It Pa /usr/doc/Makefile
828.It Pa /usr/share/examples/etc/make.conf
829.It Pa /usr/src/Makefile
830.It Pa /usr/src/Makefile.inc1
831.El
832.Sh SEE ALSO
833.Xr gcc 1 ,
834.Xr install 1 ,
835.Xr make 1 ,
836.Xr ports 7 ,
837.Xr lpd 8 ,
838.Xr sendmail 8
839.Sh HISTORY
840The
841.Nm
842file appeared sometime before
843.Fx 4.0 .
844.Sh AUTHORS
845This
846manual page was written by
847.An Mike W. Meyer Aq mwm@mired.org .
848.Sh BUGS
849This manual page may occasionally be out of date with respect to
850the options currently available for use in
851.Nm .
852Please check the
853.Pa /usr/share/examples/etc/make.conf
854file for the latest options which are available.
855.Sh CAVEATS
856Note, that
857.Ev MAKEOBJDIRPREFIX
858and
859.Ev MAKEOBJDIR
860are environment variables and should not be set in
861.Nm
862but in make's environment.
863